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The  <io*l  of  Part  T is  to  assist  the  User  Requirements  Aaalyzer 
(URA)  user  in  effort ively  using  the  URA  Modifier  Coimands 
specified  in  Part  iv,  "User  Requirements  Analyzer  Command 
Rose r ipt i ons . " This  paper  illustrates  the  usage  of  Version  3.? 
of  the  User  Peon ir e nt s Analyzer  and  specifies  the  steps  in 
creating  th?  tl'A  data  base,  inputting  User  Requirements  Language 
(URl  ) statements,  modifying  the  contents  of  the  data  base, 
joneratinq  tj p a outputs,  and  correcting  syntactical  and  loqical 
°rrors. 

rinco  UFA  is  used  in  con-junction  with  an  operating  system,  this 
ntr*  should  b<>  used  in  conlunction  with  Part  II  which  presents 
installation  dependent  features  to  be  considered  when  usinq  URA. 
"his  part  covers  installation  independent  features  of  URA, 
general  concents,  etc.  Each  section  of  this  part  has  a 
-orr  esnondi  n g section  in  Part.  II.  This  allows  easy  refarence 
^‘wcpr  general  concepts  and  the  actual  practice  of  applying 
th’m  in  a particular  installation. 
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""he  purpose  of  Part  it  is  to  assist  the  URA  user  in  effectively 
manipulating  the  UFA  command  lanquage  under  Multics.  This  paper 
covers  those  installation  dependent  features  of  ura  and  is 
intended  to  be  used  in  conjunction  with  the  User  Requirements 
Analyzer,  Part  I.  Each  section  of  this  Part  has  a corresponding 
section  in  the  User  Requirements  Analyzer.  This  Part 
illustrates  the  usage  of  Version  3.2  of  the  User  Requirements 
» n a 1 veer  . 
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PART  III  UPA  OUTPUTS 

Th°  goals  of  Part  m are  to  assist  the  User  Pequirements 
Analvzer  usa:  in  generating  reports  from  the  information  in  a 
ura  lata  base,  describe  the  standard  reports  available  in  UPA, 
and  finally,  provide  qeneral  guidelines  on  usinq  these  reports 
•■o  aid  in  the  logical  system  design  process.  In  order  to 
io derate  th*  reports  descrihel  in  this  paper  it  is  necessary  to 
understand  the  information  presented  in  Part  T and  Part  II  for 
the  installation  in  which  URA  is  beinq  used.  It  is  also 
desirable  to  use  the  "User  Requirements  Analyzer  Commands 
Rescript  ions , " "art  gy  as  a reference  for  a better  understanding 
of  the  URA  commands  and  parameters  used  to  generate  a particular 
report . 

this  part  describes  those  ura  reports  available  in  Version  3.2 
of  fhe  User  Reou irements  Analyzer. 
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PART  IV  USEJ  REJUIRFMENTS  AN  ALYEEP  COMMAND  DESCRIPTIONS 

■’'he  oblective  of  Part  iv  is  to  qive  the  user  of  the  User 
Requirements  Analyzer  (UPA)  the  list  of  the  comaands  available, 
the  correct  syntax  of  these  commands,  and  the  parameters 
allowable  for  each  command.  This  part  is  not  intended  as  a 
handbook  on  how  to  use  'IRA,  but  rather  as  a reference  for  the 
commands  available.  Part  I and  Part  II  describe  how  to  use 
these  commands  and  present  a detailed  description  of  each  of  the 
outputs  generated  by  these  coasands.  This  paper  describes  the 
facilities  of  Version  3.2  of  the  User  Requirements  Analyzer. 

The  nanner  in  which  URA  directly  interfaces  with  a particular 
operatinq  system  is  qiven  in  Appendix  E.  Also  included  in  this 
Annendix  is  a formal  description  of  the  URA  commands  available 
only  under  that  particular  operatinq  system. 
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Th n ob-jective  of  "art  v is  to  provide  detailed  operatinq 
instructions  for  the  Automatei  Documentation  System  (ADS).  ADS 
is  a stand-alone  program  and  file  structure  that  operates  on  a 
URL  data  base  to  produce  requirements  specifications  in  standard 
formats  (e.  q . , MIL  STD  UR3)  . 
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1.  INTRODUCTION 

The  first  stPD  in  use  of  the  URl/URA  system  consists  of 
specifying  i problem  statement  in  ORL  statements.  The  second 
step  consists  of  usinq  UPA  to  enter  the  problem  stateaent  into  i 
ooaputer  data  hase.  UP ^ extracts  inforaation  froa  the  1RL 
stateaents  ind  stores  it  in  a UFA  data  base.  Once  this 
inforaation  (a  oroblea  statement)  is  in  the  data  base,  it  can  be 
modified,  new  information  can  be  added  to  it,  and  reports 
presentinq  the  status  of  the  problem  statement  can  be  qanerated. 
These  actions  ace  implemented  by  the  (IRA  coaaands  available  in 
the  UFA  pcocessinq  mole.  This  mode  of  operation  aay  be  attainel 
by  arcessim  the  UP h software  available  on  a particular 
operating  system.  Therefore,  by  underst andi nq  the  operatinq 
commands  that  interact  with  UR  A and  the  UFA  command  language, 
the  problem  d’fin«»r  (user)  can  effectively  manipulate  the 
contents  of  a UP  A data  base.  Part  I,  of  this  manual,  sacves  as 
a quide  to  usinq  the  UFA  coamands. 

Operating  system  and  UR  A commands  can  only  be  used  in  their 
respective  processing  modes.  Operating  System  coaaands  can  he 
used  froa  time  of  signing  on  to  the  system,  to  the  time  access 
to  the  UFA  software  is  acquired.  At  this  point,  only  UR  A 
coamands  may  be  used  until  the  problem  definer  returns  control 
to  ♦•he  operating  system  or  terminates  processing  to  be  done  in 
UFA  mode  (through  use  of  the  Ura  "STOP"  command).  Operatinq 
system  commands  *-han  can  again  be  used  up  to  the  tiae  of  signing 
off.  This  interaction  between  operating  system  and  URA  modes  is 
illustrated  bv  ffiqute  1,  An  exception  to  this  rule  is  th*  URA 
command  "MTS"  which  allows  one  to  execute  an  operatinq  system 
command  while  in  UFA  mode. 

■"he  first,  five  sections  of  Part.  I deal  with  URA  at  in 
introductory  level.  Section  2 presents  introductory  information 
about  the  use  of  UPA.  Section  1 explains  the  procedure  of 
initializing  UFA  once  on  the  operating  system.  Sections  4 and  o 
present  practical  concepts  and  conventions  to  be  known  before 
using  UPA.  (Once  access  to  UFA  has  been  achieve!,  various 
commands  are  available;  these  commands  are  described  in  Section 
* , 1 and  9.)  Several  examples  are  given  in  these  sections  in 
order  to  better  illustrate  the  results  of  specific 
implementations.  Sections  9 and  10  deal  with  handling  errors 
encountered  in  the  use  of  UPA.  Appendix  A presents  a list  of 
all  UFA  commands  available  (and  the  parameters  for  each  commandi 
as  well  as  the  abbreviations  for  all  these  to  serve  as  a quick 
reference.  Throughout  Part  T the  long  forms  of  URA  coaaands  anl 
parameters  ire  used  interchangeably  with  their  abbreviations. 


c 

V : 


f -j 


* 


OPERATING  SYSTEM  COMMAND 
LANGUAGE  MODE 


Operating  System  Commands 


SIGN  OFF 
OF.  SYSTEM 


Figure  1:  Interaction  between  Operating  System  and  URA 
processing  modes 
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2.  ustng  up  a 

2. 1 The  URA  Com wand  Language 

^he  UFA  Comnand  Language  commands  may  be  grouped  into  three 
malor  types. 


i 


control  Co# sands 

Control  Commands  are  used  to  pass  certain  control  information  to 
the  User  Requirements  Analyzer.  These  commands  are  operating 
system  dependent  and  are  given  in  Part  II  of  this  manual.  The 
use  of  these  commands  does  not  change  the  contents  of  the  data 
base , 


Modi f ier  Commands 

Modifier  Commands  are  used  to  modify  the  contents  of  the  URA 
data  base  in  the  manner  defined  by  the  problem  definer.  These 
commands  take  legal  UPL  statements  or  URL  names  as  input.  URA 
then  generates  error  diagnostics  as  well  as  an  output  report  to 
present  the  outcome  of  the  data  base  alteration. 


” epo rt  Commands 

Report  Commands  retrieve  data  from  the  UFA  data  base  and  output 
it  in  some  standard  format.  These  reports  do  not  change  the 
contents  of  the  data  base  whatsoever.  Their  purpose  is  solely 
that  of  displaying  some  or  all  of  the  contents  of  the  data  base. 


2.2  Comm  and  Parameters 

Most.  UP. A commands  have  parameters  which  may  be  set  by  the  user 
to  modify  the  actions  of  the  command.  There  are  basically  five 
types  of  parameters: 

Innut  data  parameters  - these  parameters  specify  the  data  to  be 
used  as  inout  to  the  command.  INPUT,  PILE  and  NAME  are 
examples  of  Input  data  parameters. 

Input  control  parameters  - these  parameters  specify  how  the 

inout  data  is  to  be  used,  changed,  etc.,  by  the  command. 
The  TYPF  parameter  for  the  CHANGE-TYPE  command  and 
CONTAINED/CONSTSTS  parameter  for  the  CONSISTS-H ATRl X 
command  are  examples  of  this  type. 

Output  data  parameters  - these  parameters  specify  if  output  is 
to  be  generated  from  the  command  and  the  form  in  which  it 
is  presented.  The  PUNCH  and  PRINT  parameters  are  examples 


} 


[ 
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of  this  type  of  parameter. 


Output  option  pa  rams  tors '-^these  paraaeters  specify  options 
which  lav  he  included  or  omitted  froa  the  output.  The 
LEVFLS  parameter  for  the  CONTENTS  coaaand  and  the 
DESCRIPTION  parameter  for  the  DICTIONARY  coaaand  are 
examples  of  this  type. 


Outnut  format  parameters  - these  parameters  specify  alternate 
formats  for  prasentinq  the  information  in  the  output  from 
the  coaaand.  The  NFW-PAGE  parameter  and  HHARG  panaeter 
for  the  EPS  command  are  exaaples  of  this  type. 


?.  1 Sequence  of  commands 

Although  all  of  ♦•he  commands  can  he  issued  independently  of  each 
other,  it  i3  often  advantageous  to  use  some  commands  in  sequence 
since  the  output  of  one  command  may  be  used  as  input  by  another. 
The  most  common  instance  of  this  is  when  NAME-GEN  is  used  to 
select  certain  names  (say  all  PROCESSES  for  example)  which  can 
then  he  used  as  input  to  a Report.  Command  (possibly  PICTURE,  for 
a picture  REPORT  for  all  PPOCESS  names).  Though  NANE-GBN  is 
technically  classified  as  a Report  Command  one  of  its  major 
functions  is  to  selectively  retrieve  names  stored  in  the  data 
base.  PUNCH-CDM  MENT-ENTR  Y and  FEPLACE-COHfl  ENT -ENTRY  often  occur 
in  sequence.  wor  more  information  about  use  of  these  commands, 
see  "ORA  Outputs"*  and  "URA  Command  Desr iptions.  "* 


2.4  The  HELP  Com mand 

The  HELP  Command  provides  the  user  with  information  about  the 
syntax  and  parameters  of  UFA  commands.  The  HELP  command  does 
not  affect  the  manna  r in  which  (IRA  operates  nor  accesses 
information  in  the  data  base.  For  this  reason,  it  is  not 
classified  as  a Control,  Modifier  or  Report  Command.  When  the 
HELP  command  is  qiven,  UFA  displays  a list  of  all  available  URA 
commands  and  their  abbreviations.  By  specifying  a particular 
UR  A command  n ame  as  a parameter  to  the  HELP  command: 

HELP  CONTENTS 

for  example,  all  ♦‘he  parameters  available  for  this  command  will 
be  printed.  If  the  "LONG"  parameter  were  given  in  conjunction 
with  a command  name: 

HELP  EPS  LONG 


* Part  III 

* Part  17 
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ill  parameters  for  the  FOpM ATTEP-PROBLEM-STA THMENT  coaaind  woull 
he  printel  out  is  wall  as  a description  of  the  function  of  each 
of  these  parameters  for  the  command.  This  description  is 
presented  in  the  same  format  as  that  in  "User  Requirements 
Analyser  Command  rescript  ions. " 1 To  illustrate  an  example,  when 
"l!rl  ? co vtfn TS"  was  qiven  the  followinq  information  was  printed: 

COT""  rNT S 

Prototype;  CONSENTS  (CONT)  [parameter]  ... 

Parameters: 

FTLFf  *f  dname  ],  N AM  F ( N)  = user 
TN^FX,  NOTNDFX 
LFVFLS= inteqer , LEVFLS=  ALL 

ncfla:,  moncflac 


3.  TMF  UpA  FNVIRONMFNT 

Th * considerations  necessary  for  usinq  UPA  and  preparing  for 
usinq  UPA  d»fine  *h?  URA  environment.  The  following  points  must 
be  considered: 

- How  the  data  base  is  prepared. 

- How  'IP A i3  executed. 

- How  MPA  is  used. 

- 'low  hatch  use  ->f  up*  is  different  froe  terminal  use. 

The  first  three  points  are  presented  in  section  3.1,  "Initiating 
•IRA,"  and  the  last  point  is  presented  in  section  3.2,  "Batch 
Versus  on-lin’  Use  of  ’IRA."* 


name  Default: 

FILE 

Default : 

NOINDEX 

Default : 

ALL 

Default: 

NONCPLAG 

3.  1 Initiating  UPA 

"he  steps  required  to  prepare  a UPA  data  base  for  access  by  UPA 
are; 

i)  The  UPA  data  base  file  must  be  created. 


Creation  of  the  data  base  file  occurs  only  once.  Dnce 


• Part  IV 

* ""he  exact  commands  to  carry  out  the  above  procedures  are 
installation-dependent  and  can  be  found  in  Part  II  (Section 
3.  1)  . 


Part.  I User  Requirements  Analyzer 


■ HHBBi 


HMRC/Mul  tics/URA  riser's  Manual 


9 


created,  any  changes  to  be  wade  (including  emptying  the 
whole  file)  can  be  nade  without  destroying  it. 

ii)  The  data  base  mist  then  be  initialized  in  order  to  be 
accessed  by  ura. 


Initialization,  for  the  eost  part,  occurs  only  ones,  at  the 
tier  of  creating  the  data  base.  The  data  base  must  be 
reinitialized  if  enptied. 

FxecuMng  mpa  involves  running  the  UR  A program.  This  allows  tha 
us»r  to  specify  UFA  commands  to  change  the  contents  of  the  data 
base  or  generate  reports  about  its  contents. 

Once  the  UR  A Drograa  has  been  invoked  the  following  steps  are 
suggested  in  using  UPA: 

i)  ’’'he  data  base  to  be  accessed  by  the  w R A coaaands  aust  be 
specified. 

This  should  he  done  any  time  IIRA  is  used  to  ensure  that  the 
user  is  accessing  the  correct  data  base.  In  some  cases  tha 
data  base  to  be  used  will  set  by  default  any  tiao  the  user 
executes  'IP  A.  Fven  if  this  is  the  case,  the  user  should  be 
aware  that  *he  default  is  in  effect. 

ii)  UFA  coaaands  ni » given  to  aodify,  update  and/or  generate 
reports  on  the  lata  base  information. 

Any  of  the  commands  qiven  in  "User  Requi resents  Analyzer 
Cowean  1 Descriptions"*  can  be  issued  to  accomplish  these 
tasks.  Tho  ocler  in  vdich  commands  are  given  and  which 
commands  are  given  is  determined  by  the  user. 

iii)  The  STOP  command  is  given  to  terminate  the  URA  session. 


"*•-  isim*  QGrliDf  Us?  2i  y£i 

The  manner  in  which  a user  interacts  with  URA  via  batch 
processing  differs  from  on-line  (terminal)  usage.  There  are 
various  advantages  and  disadvantages  to  either  approach.  A few 
of  these  are  jiv*»n  in  Table  T. 

The  procedures  givan  in  section  3.1  are  the  same  for  both 
on-line  and  ba*ch  me  of  UFA.  The  specific  manner  in  which  URA 
commands  are  given  by  the  user,  however,  is  different. 

In  batch  processing  of  UFA  commands,  URA  commands  are  given,  one 
n«r  card,  following  the  card  which  executes  the  PRA  prograa. 


* Part  T» 
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Any  orrors  detected  in  specifying  the  command  (jc  its 
n \ ra  m^*  ers)  cause  the  command  to  be  ignored,  ami  (JRA  then  tores 
to  t he  nex*  command. 

when  executing  UFA  in  on-line  mode,  the  user  *ust  wait  for  the 

PNTR  COMMAND  ( AN  P ANY  PAP  A METERS) 

before  giving  try  commands.  After  typing  in  the  coimand 
Followed  bv  a carriage  return,  the  user  must  wait  again  until 
••V'  command  prompting  messaj°  is  issued  before  entering  the  next 
command.  If  an  error  occurs  when  specifying  the  coaiand  (or  its 
parameters)  the  user  will  be  prompted  for  a replacement. 

Hn -_1  i n e Use  of  UP  A 

Anv ANTAGES 

The  user  is  able  to  handle  errors  as  theyoccuc.  Errors  can 
h«  corrected  before  an/attempt  is  made  to  raodifyor  retrieve 
information  in  th«  data  base. 

which  UFA  commanls  to  be  issued  and  the  order  in  which  they 
are  given  Inns  not  have  to  be  predetermined,  i.e.,  the  user 
mnv  issu°  commands  ad  hoc. 

Utilizing  the  »dit  facility  of  the  operating  systea  allows 
the  user  to  mike  changes  to  information  in  the  data  base 
nuickly  and  efficiently. 


PIS  ADV  ANT  AGES 

Toss  of  connection  between  terminal  and  computer  (line 
hits)  lav  cause  the  contents  of  the  data  base  to  become 
unusable.  Recovery  procedures  would  be  required  to  restora 
the  data  base  contents. 

On-line  usa  is  generally  more  expensive  than  batch  because 
of  connect  time  costs  an  1 other  additional  costs  related  to 
terminal  access. 


Ra_tch  Use  of  UFA 
AP VANTAGES 

* - Reouires  the  ura  user  to  think  out  procedures  (list  of  (IRA 

commands)  t o be  executed  before  they  are  executed. 

- Cheaper  to  run  than  on-line  use. 

- All  output  generated  bv  UFA  is  printed  in  a usable  forest. 
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via  th*  lino  printer.  Output  qenerated  at  the 
terminal  my  ho  part  of  the  terminal  listing  and 
interspersed  eith  other  information. 


‘’“able  1.  Comparison  of  On-Line  Versus  Batch  Use  of  (IRA 
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DISADVANTAGES 

Turn-around  time  for  -jobs  nay  be  lonq. 

Editing  of  information  in  the  'lata  base  may  require  two 
batch  runs;  on“  to  retrieve,  one  to  repLace. 

Frrors  are  ignored  and  any  subsequent  URA  coaaands  would  b® 
run  teqardless. 


Table  1,  continue  1 


U.  G Ppc  t py  ▼ r r;  INPUT  TO  MPA  COMMANDS 

Por  aor>t  up  a commands,  one  or  more  naaes  (specified  by  the  user) 
can  be  used  as  "innut"  to  the  command.  This  can  be  dona  by 
utilizing  'hp  "input  data"  parameters  for  the  command.  In  the 
case  of  Modifier  Commands,  the  modification  is  lade  for  each 
name  used  as  input.  For  Report  Commands,  information  is 
retrieved  for  Pirh  of  the  names  used  as  inout.  Except  for  the 
TNPUT-PSL  comman  d,  all  names  used  as  input  to  the  Modifier  and 
°eport  Commands  must  be  names  already  stored  in  the  problem 
defi net's  UP  A data  base. 


« . 1 ^ he  NA-E  Par  amet  er 

There  are  two  methods  of  specifyinq  names  to  be  input  to  a 
command.  ^he  simplest  way  is  to  use  the  NAME  parameter.  When 
this  narameter  is  used,  the  modification  will  be  made,  or  a 
report  will  he  generated,  for  only  that  name  specified  by  the 
n A M P parameter.  For  example,  if  NAME=T-CARD  were  used  for  the 
u ELETr  command,  only  T-CARD  would  be  deleted  from  the  data  base. 
Likewise,  if  NAM  r‘  = ,p-C  AFD  were  used  as  a parameter  for  the 
CON"ENTF  command,  the  CONTENTS  PEPOPT  would  be  generated  for  the 
name  T-CARD,  and  no  others. 


u.2  The  2ILF  and  INPUT  Parameters 

The  second  wav  to  specify  names  as  input  to  a URA  commaad  is  to 
put  all  the  names  for  which  the  modification  is  to  be  aide,  or  a 
report  generated,  into  a file  and  specify  that  the  contents  of 
that  file  ace  to  be  used  as  input.  At  most  installations  this 
specification  can  simply  be  done  via  the  FILE  and  INPUT 
parameters,  but  varies  slightly  from  one  installation  to  the 
next.  (Gee  Part  II.)  FILE  and  INPUT  are  different  in  the  way 
names  can  be  formatted  within  the  file  specified  by  these 
parameters.  When  using  the  FILE  parameter,  each  name  in  the 
specified  file  must  heqin  in  the  first  column  of  each  line  of 
the  file  and  only  one  name  per  line  is  allowed.  The  format  for 
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files  specified  by  the  INPUT  parameter  varies  according  to  the 
UP*  command  using  this  paraaeter.  For  example,  if  a file  is 
used  as  input  to  th»  TNPUT-PSL  coaaand,  the  file  aust  consist  of 
URL  stateaents  to  b?  entered  into  the  UFA  data  base.  For  those 
Hodifier  Coaaands  that  allow  the  INPUT  paraaeter,  the  particular 
foraat  needed  for  the  input  file  is  specified  in  the  description 
of  each  coaaand. 

Tf  one  particular  file  name  is  used  throughout  a given  terainal 
session  to  contain  various  inforsation  and  naae  lists  to 
interact  with  mra  commands,  the  user  should  reaaaher  to  eapty 
the  file  before  each  tiae  new  data  is  to  be  written  into  it. 
otherwise,  inforaation  used  as  input  to  a previous  coaaand  may 
be  leftover  when  using  the  file  with  subsequent  coaaands. 


4.3  Entering  2iti  Ill2  SH  lElEii.  Li 1** 

The  manner  in  which  data  is  entered  into  a file  is 
installation-dependent.  See  Part  IT,  Section  4,  for  the  details 
of  this  procedure. 


4.4  Using  NANS^GEN 

One  alternative  to  specifying  input  to  nodifier  and  Report 
Coaaandp  is  to  let  NAME-GEN  qenerate  the  input  file.  The 
various  parameters  for  NANE-GEN  allow  selection  of  particular 
types  of  naaes  that  are  desired  (e.g.,  all  GROUPS  and  ENTITIES) 
and  retrieval  of  thsse  naaes  which  are  then  put  into  a file  by 
UP  A . The  names  are  formatted,  one  naae  pec  line  starting  in  tha 
first  column  of  the  line.  The  contents  of  this  file  can  be  use! 
as  input  to  a Report  Command  or  Hodifier  Command.  For  axaaple, 
bv  specifying: 


‘JAN  E-GEN  S=  • ENTITT  OR  GROUP' 

GONTENTS 

in  sequence,  the  CONTENTS  REPORT  will  be  generated  for  all 
ENTITY  and  GROUP  naaes  in  the  UFA  data  base.  In  addition,  the 
contents  of  the  file  produced  by  NANE-GEN  are  maintained  until 
the  next  NANF-GFN  is  issued. 


4. 5 Using  LUNCH  files 


PUNCH  files  are  files  which 
INPUT  parameters.  The  file 
a PUNCH  file  from  the  NAME-: 
nut  into  its  assigned  PUNCH 


have  formats 
described  in 
EN  coaaand. 
file  so  that 


acceptable  by  PILE  or 
the  previous  section  is 
Output  from  NAS E-GFN  is 
it  may  be  used  as  input 


to  any  of  the  FILE  parameters  for  Nodifier  and  Report  Coaaands. 
The  PUNCH  file  format  is  different  from  the  report  focait  for 
the  coaaand  that  generates  both  of  them.  For  example,  upon 
execution  of  the  NANE-GEN  coaaand  for  all  PROCESSES,  the  report 
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generated  will  consist  of  a report  heading,  line  numbers  for  the 
contents  of  the  report,  the  names  of  all  PROCESSES  in  the  data 
base  and  their  corresponding  name  type  (which  is,  of  course, 
PROCESS).  The  contents  of  the  PUNCH  file  produced  by  this 
command  will  only  contain  the  names  of  the  PROCESSES,  without 
reoort  headings,  etc.  In  other  words,  the  PUNCH  file  contains 
similar  information  to  the  report  output,  from  the  command,  but 
in  a format  acceptable  to  the  PILE  and  INPUT  parameters  of  other 
'TP A commands. 

At  most  installations,  the  PUNCH  file  to  be  used  (name  of  the 
file)  can  be  specified  by  the  PUNCH  parameter  for  the  command, 
’’’he  manner  of  assignment  varies  slightly  from  one  installation 
to  the  next.  (See  Part  II,  Section  4.)  Specific  usage  of  the 
°UNCH  parameter  is  given  in  the  descriptions  of  the  individual 
commands  that  utilize  this  parameter.  The  specific  names  of  the 
PUNCH  files  used  can  be  found  in  the  appropriate  Addendum  for 
Appendix  E. 


S.  PECrIVINr,  OUTPUT  EPOM  UP  A COMMANDS' 

Several  UFA  commands  allow  the  user  to  specify  whether  output  is 
generated  from  the  command  or  not.  This  is  done  via  the  "output 
data"  parameters  for  the  particular  command.  When  generating 
outputs  from  UFA,  the  information  is  put  into  a file  or  printed 
on  a device  such  as  a line  printer  or  terminal.  If  this  file  or 
levice  is  not  specified  then  all  outputs  are  written  to  the  main 
output  file  or  device.  This  means  that  output  will  be  written 
on  the  terminal  when  in  conversational  mode  and  on  the  line 
printer  when  running  batch.  There  are  several  reasons  why 
outnuts  might  he  routed  elsewhere,  expecially  for  on-line 
Drocessinq: 

- Large  guantities  of  output  would  take  too  long  to  be  printed 
at  the  terminal. 

- Depending  on  the  type  of  terminal,  some  portions  of  the  output 
may  no'  be  printed  because  of  physical  restrictions  imposed  by 
the  terminal. 

- The  handling  of  printout  from  the  terminal  can  sometimes  be 
awkward  and  the  format  not  aesthetically  pleasing. 

- No  copy  of  the  output  is  desired.  (Only  the  PUNCH  file  may  ba 
needed  as  a steo  in  a modification  procedure.) 

Most  methods  of  receiving  and  controlling  output  from  ORA 


1 This  section  only  deals  with  receiving  outputs  in  the  form  of 
reports  (as  specified  in  Part  III).  Receiving  output  as 
presented  via  the  PUNCH  parameter  is  discussed  in  the  previous 
sect  ion . 
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commands  are  installation  dependent  and  therefore  given  in  Part 
It,  Section  5. 


*•1  2il£  £2£&I!LI  £a£l£”t«£ 

Several  UFA  commands  allow  the  option  of  not  having  the  output 
printed  via  the  NOPRINT  parameter.  The  coaaands  that  allow  this 
parameter  are: 

DELETE-COMMENT- ENTRY  (DCOM) 

FORK  ATFD-PROBLEM-ST  ATENENT  (PPS) 

NAME-GEN  (NG) 

PPI NT-COMNENT-EN  TPY  (PCOH) 

PROCESS- INPUT-OUTPUT  (PRIO) 

RFPL  ACE-COMM  ENT- ENTR  Y (RCOM) 

■E 

The  two  Modifier  Commands,  RCOM  and  DCOM,  have  this  parameter 
available  because  the  printout  can  be  fairly  large  and  nay  not 
he  needed  for  future  reference.  The  report  heading  for  the  RC01 
or  DCOM  output  and  any  error  diagnostics  are  still  printed  to 
provide  a hard-copy  record  of  the  command  execution. 

The  remaining  four  Report  Commands  can  use  this  paranetsr  in 
conjunction  with  the  PUNCH  parameter.  The  option  of  the  NOPFINT 
parameter  is  provided  because  when  PUNCH  information  is  desired, 
th«»re  may  be  no  need  for  the  printout. 


S, 2 The  INDEX  Paramat  er 

Several  commands  allow  the  user  to  specify  that  an  index 
(alphabetic  listing  of  names  used)  for  the  report  be  generated 
by  the  command.  The  index  also  specifies  the  paqes  on  which 
these  names  occur  in  the  report.  This  is  done  by  specifying 
INDEX  as  a oarameter  for  the  command.  The  commands  which  allow 
this  parameter  are: 

CONTENTS 

DICTIONARY 

EXTENDED-PICTURE 

FORM  ATTFD-PROBLEH-STATEMENT 

PICTURE 

PPOCESS- CHAIN 

PROCESS  - INPUT -OUT  PUT 

RESOURCE 

SECURITY 

STRUCTURE 
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The  N0522BCI  anl  XPEf  gaiametej^s 

Th ° NPSOURCE  anl  XREF  parameter  have  the  same  function  for  the 
INP'iT-PEL  and  nFLFTE-PSL  commands  as  the  NOPRINT  and  INDEX 
parameter  far  other  URA  commands.  The  report  produced  by  XREF, 
however,  (the  MR  A CROSS  REFERENCE  LISTING)  specifies  tha  lines 
rather  than  the  pages  where  th»  names  occur. 


h.  CONTROL  COMMANDS 

*11  control  commands  are  installation-dependent.  For  this 
reason  all  control  commands  available  to  a particular 
installation  and  t h ■»  descriptions  and  usaqe  of  these  commands 
ar®  giv®n  in  Part  II,  Section  6. 


MODIFIER  COMMANDS 

All  the  commands  in  this  section  modify  the  URA  data  base  in 
some  manner  and  generate  an  output  to  present  the  result  of  the 
modification.  Thes->  outputs  provide  the  user  with  a permanent 
record  of  changes  made  to  the  problem  statement  in  the  lata 
ha  s<» . 


of  32difi“C  Commands  oq  the  Data  fiage  S££ygty£g 

Thero  are  basically  three  types  of  information  stored  in  a URA 
data  base: 

1)  Name  and  types  of  objects  defined  by  the  user. 

2)  Comment  entries  (narrative  and  free  format  descriptions  of 
objects)  . 

t)  Connections  among  oblects  and  between  an  object  and  comment 
entrv  . 

All  this  information  is  entered  into  the  data  base  via  INPUT-PSL 
From  the  URL  statements  used  as  input  to  this  command.  In  most 
cases  the  section  header  statements  define  the  type  of  objects 
anl  names  of  the  objects,  comment  entry  statements  (DESCRIPTION, 
for  example)  define  comment  entries  to  he  stored,  and  other  URL 
statements  define  relationships  or  connections  among  tha  named 
oblects  in  the  data  base.  To  present  the  structure  of  the  data 
base  in  a graphical  manner,  the  following  symbols  will  be  used: 


- svmbol  for  record  used  to  describe  a 
given  named  object  (nane  record). 

A 
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- syibol  for  cosaent  entry  storel  in  data 
base. 


• syibol  for  a NUB r a type  of  record  used 
to  like  connections  anong  objects  and 
between  an  object  and  conent  entry. 

Using  the  above  notation,  a staple  relationship  between  two 
objects  (naae  records)  aany  look  like: 


Data  in  the  NUB  defines  the  type  of  connection  (RECEIVES,  for 
example)  and  the  direction  of  the  arrows  defines  the  Banner  in 
which  the  relationship  should  be  interpreted,  i.e.,  whioh  object 
does  the  RECEIVING. 

A connection  between  an  object  and  a consent  entry  aay  look 
like: 


The  data  in  the  NUB  defines  the  type  of  coaaent  entry 
(PROCEDURE,  for  exaaple) . 

It  is  ieportant  to  note  that  the  connections  aade  anong  objects 
are  different  froa  the  connection  aade  between  an  object  and 
consent  entry. 

INPUT-PSL  creates  records  for  naaed  objects,  the  NUB  reoords 
connecting  the  objects,  and  the  coaaent  entries.  Coaaaads  nust 
also  be  available  to  do  the  following: 

1)  Change  a nane  record 

i)  change  the  naae  of  the  object 
ii)  change  the  object  type 

2)  Delete  a connection  between  objects 

1)  Delete  a naae  record  (and  any  connections  it  had  with  other 
objects) 

4)  change  a coaaent  entry 


: 
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S)  Delate  a comieni;  entry 

UR*  has  facilities  to  perform  all  of  these  modifications  on  the 

data  base  information.  The  following  UPL  commands  perform  the 

actions  core  onding  to  the  above: 

1)  change  a name  record: 

i)  Change  the  name  of  an  object.: 

FFNA^E  - This  command  changes  information  within 

the  name  record  only. 

ii)  Change  the  object  type: 

CH  AMTE-TY P E - This  command  changes  information  within 

the  name  record  only. 

2)  Delete  connections  among  objects: 

DELE?P-  PSL  - This  command  deletes  HUBS  (and  thus 

connections)  among  name  records  in  the 
data.  It  does  not  delate  name  records 
or  comment  entries. 

R)  Delete  name  records: 

DFLET  - This  command  deletes  name  records. 

Names  to  be  deleted  having 
connections  with  other  names  and/or 
having  comment  entries  associated 
with  them,  will  have  corresponding  HUBS 
(and  comment  entries)  deleted. 

U)  Chancje  comment  entries: 

RE PLAC E-CO MKFNT -ENTRY 

- This  command  changes  information  within 
the  comment  entry  only. 


5)  Delete  comment-entries: 

DELETE -COM 1FNT- ENTRY 

- This  command  deletes  comment  entries 
and  also  deletes  corresponding  HUBS. 

Modi  f ier  Command  Descript. ion  Format 

Pach  Modifier  Command  will  be  described  in  the  following  format: 
Command  Name  (common d abbreviation) 
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When  specifying  the  coaiand  to  be  executed,  either  the  long  fori 
of  the  command  name  or  legal  abbreviations  of  the  naee  lay  be 
given. 


Modi f icatjon  Made 

All  Modifier  Commands  change  information  in  the  URA  data  base. 
What  tvpe  of  information  is  chanqed  and  how  it  is  changed  is 
described.  Also,  the  checks  made  by  UPA  before  ' ’ie  change  is 
made  are  presented. 


output  Poser i pt  j on 

All  Modifier  Commands  generate  an  output  to  present  the  result 
of  the  modif  icat.  ion  (s)  made.  The  name  of  the  output,  purpose  of 
the  output,  contents,  and  diagnostics  given  in  the  output  are 
presented  to  aid  in  using  it. 


Execution 

The  basic  form  of  specifying  the  command  to  be  executed  is 
described.  An  example  of  how  this  is  done  and  the  results  from 
the  action  are  given. 


n pti ons  and  Alternat  jve3 

All  Modifier  Commands  can  ha  executed  in  more  than  one  nay.  Por 
example,  a different  form  of  the  command  nay  be  used  to  change 
one  name  in  the  data  base  varsus  a number  of  names.  Also,  the 
“ffpet  which  the  parameters  for  the  command  have  on  modifying 
the  da*a  is  described.  Examples  are  given  to  illustrate  the 
alternatives . 


Common  Errors 

Tt  is  possible  to  make  particular  errors  in  the  use  of  each 
"odifier  Command.  Some  of  the  particular  logical  and 
syntactical  errors  that  occur  when  executing  the  command  are 
given . 

The  following  commands  are  described  in  this  section  in 
alphabetical  order: 

7.1  CHANGE-TYPE 

7.2  DELETE 

7.3  DPLPTE-COM»'ENT-ENTPY 
7.«  DELFTE-PSL 

7.8  INPOT-PS L 
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7.*,  PUNCH-GO  !11FN,’'-EN','RY 
7.  7 PFNAME 

7.9  PFPl.  ACE- C01H  ENT- ENTRY 


7.  i £HAN£I;II£S  jc?|_ 


Nodi  f jcat  ion  !1ad  e 


Each  name  specified  as  input  to  this  command  has  its 
corr espondi n q name  type  changed  if  the  new  type  does  not 
conflict  with  the  context  in  which  the  name  has  previously  been 
us’d . This  modification  is  most  often  used  to  change  an 
underlined  name  (***  UNDEFINED  ***)  to  a specific  name  type 
(such  as  G^OUP  or  Ei.FMFNT).  Various  "checking"  facilities  must 
he  used  to  ascertain  that  leqal  chanqes  are  being  made.  For 
■»ich  name  type  change,  UP  A must  check  to  see  that; 

i)  Th e name  whose  name  typo  is  to  be  changed  exists  in  the  data 
base . 

ii)  "ho  assiqnment  of  the  new  name  type  is  consistent  with  the 
context  in  which  the  name  was  used  previously. 


output  descr i pt i on 

The  output  generate!  by  this  command  is  the  CHANGE-TYPE  REPORT. 
This  report,  presents  for  each  name  used  as  input  to  the 
CHANC.F-TTPF  command,  the  name,  the  old  name  type  associated  with 
it  and  the  new  name  type  now  assigned  to  it.  Any  error 
diagnostics  which  may  occur  during  the  name  type  chanqe  will 
also  te  printed.  The  names  are  printed  out  in  the  same  order  in 
which  they  were  rpad  as  input  to  the  CHANGE-TYPE  coamani. 


Execution 

To  change  the  name  type  of  only  ore  name,  the  following  command 
format  is  issued: 

CHANGE-TYPE  NAHE-qross-pay  TYPE=GR3UP 

Previously  in  the  nroblem  statement.,  "gross-pay"  had  bean 
defined  as  a FT.EMFNT.  It  was  more  appropriate  to  call  it  an 
Group,  and  the  CHANG F-TY  rr  command  made  it  easy  to  facilitate 
this  change,  the  resulting  CHANGE-TYPE  REPORT  is  shown  in 
pigure  ?. 


Opt i ons  and  Alternatives 

i)  The  name  types  of  several  names  can  be  changed  at  one  time 
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if  th°  names  are 
as  innut  to  the 
FIT. F parameter.  ) 
a file  as  input 
example  are  show 
FLEMENTS.  The  r 
a GROUP,  "number 
GPOup  and  "gross 
line  of  the  inpu 
followed  hv  the 
format  is  accept 
name  type  and  t h 
of  the  file  line 
them.  The  file 


put  into  a file  and  the  file  is  specified 
command.*  (This  is  usually  done  via  the 
Fiqure  3 is  an  output  resulting  from  using 
to  CHANGE-TYPE.  All  the  names  in  the 
n to  have  been  previously  defined  as 
eport  shows  that  "birthdate"  was  changed  to 
-of-ded uc t ion s"  became  a GROUP,  "surname"  a 
-nay"  changed  back  to  an  ELEMENT.  Each 
t file  consists  of  the  name  of  an  object 
new  name  type  to  be  assigned  to  it.  The 
able  if  the  name  is  followed  by  its  new 
e two  are  within  the  first  eighty  columns 
and  there  is  at  least  one  blank  between 
used  to  generate  Figure  3 was: 


birth  Tate  GPOUP 
n umbe r-of - deducti on s GROUP 
surname  GPOUP 
gross-pay  ELEMENT 


2)  The  TYPE  parameter  can  also  be  used  effectively  with  an 
innut  file.  All  names  in  the  input  file  will  have  their 
name  types  changed  to  the  name  type  specified  by  the  TYPE 
parameter.  If  the  file  from  the  previous  example  was 
specified  as  input  and  the  TYPE  parameter  was  also  used, 
only  the  names  in  the  file  would  be  read  as  input;  the  name 
types  would  bp  ignored.  All  the  names  specified  ii  the 
input  file  would  have  their  name  types  changed  to  that 
oiven  by  the  TY PE  parameter.  Pigure  4 presents  the  output 
resulting  from  a CHANGE-TYPE  command  with  TYPE=BLESENT  and 
♦■he  names  useT  as  input  are  the  same  as  that  used  for 
figure  3. 


3)  It  is  sometimes  advantageous  to  use  NAME-GEN  in  conjunction 
with  CHANGE-TYPE,  i.e.,  use  the  output  produced  by  NAME-GEN 
as  innut  to  CHANGE-TYPE.  This  is  most  often  done  when  all 
names  of  a particular  type  (usually  UNDEFINED)  are  changed 
to  another  type  (GROUPS  or  ELEMENTS).  To  change  all 
undefined  names  in  the  data  base  to  GROUPS: 


NAME- GEN  S=' UNDEFINED* 

CHANGE-TYPE  FILE  TYPE=GPOUP 

The  NAME-GEN  command  selects  all  undefined  names  and  places 
them  in  a file.  The  CHANGE-TYPE  command  then  uses  the  file 
produced  hv  NAME-GEN  as  its  input  file.  The  TYPE=3R0UP 
parameter  specifies  that  all  the  names  in  the  input  file 
should  be  chanqed  to  GROUPS.  Figure  5 presents  the  result 
of  this  procedure. 


» Th  a*  exact  manner  in  which  the  file  is  specified  is  given  in 
Part  II,  Section  7.1. 
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£25522  l££2£5 

If  neither  an  input:  file  nor  H A MZ  is  specified  for  the  command, 
th“  aessag®:  "NO  NA«tp  GIVEN"  will  be  printed  by  ORA.  If  a file 
or  N AMP  is  given,  hut  no  name  types  are  given  in  the  file  or  no 
TYPE  is  given,  the  message;  "MO  TYPE  GIVEN  WITH  "NAME*"  OR 
"PILE"  PARAMETER  will  be  printed.  .Should  eithec  of  these 
messages  he  generated,  'JRA  will  not  execute  the  CHANGE-TYPE 
command.  The  command  and  its  parameters  should  be  re-entered 
with  the  necessary  corrections.  Another  common  error  is 
attempting  to  assign  a new  naae  type  to  a name  that  has 
previously  been  used  in  a way  that  conflicts  with  its  naw  name 
type.  For  example,  if  the  name  XYZ  was  previously  defined  to  ba 
CONTAINED  in  SET  Si,  this  would  imply  that  XYZ  must  be  either  an 
ENTITY,  INPUT  or  OUTPUT.  If  an  attempt  was  made  to  change  its 
type  to  a GROUP  (which  cannot  be  CONTAINED  in  a SET)  tha  error 
message; 

upA^PPrilATNCr;  CONFLICT  WITH  EXISTING  CONNECTIONS 

would  be  given  and  the  change  would  not  be  made.  If  it  is  still 
desired  that  XYZ  he  a GROUP,  XYZ  should  be  deleted  from  the  data 
base  and  proper  UPL  statements  for  XYZ  should  be  enterel  via 
INPUT-PSL.  All  conflicting  connections  are  listed.  They  ail 
must  be  resolved  before  the  change  of  type  can  occur. 


7.7  Delete  1£ELL 


"odi f icat ion  Made 

"or  each  name  specified  as  input,  to  the  DELETE  command,  ail  its 
relationships  (i.e.  , USES,  SUBPAPTS,  etc.),  with  other  names  in 
the  data  base  are  removed,  its  comment  entries  (such  as 
description  or  PROCEDURE)  are  deleted  and  finally  the  name  is 
deleted  from  the  data  base.  Before  any  of  these  modifications 
are  made,  UR  A checks  that  the  name  to  be  deleted  exists  in  the 
data  base.  If  the  name  cannot  be  found,  no  attempt  will  be  aada 
by  UFA  to  delete  *he  name. 


SaiEMl  Descr  jot^on 

The  DFLFTION  REPORT  is  produced  each  time  this  command  is 
Initiated.  Each  name  used  as  input  to  the  DELETE  command  is 
printed  on  the  report  along  with  the  status  of  the  change  (i.e., 
if  it  did  or  did  not  work).  The  names  on  the  output  appear  in 
the  same  order  as  read  by  the  DFLETE  command. 

This  report  serves  as  a permanent  record  of  names  that  have  been 
deleted  from  the  ura  data  base.  It  is  intended  to  aid  the 
analyst  in  keening  track  of  modifications  to  the  data  base. 


I 


! 
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■>ncp  there  is  a record  of  a particular  name  being  deletad,  the 
analyst  has  the  ontion  of  r°-usinq  the  name. 


P»pcu»ion 

Th°  tollowinq  command  deletes  one  name  from  the  data  base: 

DELETE  NAM E=remain inq- funds 

~he  PELFTION  F^POFT  for  this  action  is  shown  in  Figure  6. 

Opt  i ons  and  A lte  mat  i ves 

1)  Several  names  can  be  deleted  from  the  data  base  if  the  names 
are  put  into  a file  and  the  file  is  specified  as  input  to  the 
command.1  (This  is  usually  done  via  the  FILE  parameter.)  The 
format  of  *he  innu*  file  consists  of  one  name  per  line, 
beginning  in  column  one.  Fiqure  is  an  output  resulting  from 
using  a file  as  innut  to  the  DELETE  command.  All  the  names  in 
'h«  report  had  bo»n  defined  in  the  data  base.  The  report  shows 
♦■hat  deletion  of  each  name  was  successful. 


Common  Errors 

DELETE  should  not  b?  used  to  delete  the  entire  contents  of  the 
lata  base.  Operating  system  command  should  be  utilized  for  this 
nrorodur®.  Th®  data  bas<®  should  be  emptied  and  then 
r°in itia lixed  . 

when  doing  minor  elitinq  of  a OFL  description  for  a name  in  the 
data  base  the  information  connected  to  that  name  (ORL 
statements)  should  be  saved  before  deleting  the  name.  A 
^ORM  ATTFD-oooPT.EM-ST  ATEM^NT  for  the  name  should  be  generated 
using  the  °UMCH  parameter.  Then  the  name  can  be  deleted  (via 
DFI.PTF)  from  the  data  base.  At  this  point,  the  old  information 
in  the  PUNCH  file  can  be  edited  to  suit  the  problem  definer  and 
♦■hen  re-entered  via  the  INPUT-PSL  command  using  the  PUNCH  file 
produced  hv  the  ^PS  as  input. 

If  a file  is  used  as  input  to  the  command,  all  names  to  be 
deleted  must  begin  in  the  first  column  of  the  file  line.  Any 
ocecedinq  blanks  will  be  interpreted  as  part  of  the  name. 

Tf  neither  an  input  fil<®  nor  NAME  is  specified  for  the  command, 
the  message:  "NO  NAME  0?  ^ILF  HAS  SPECIFIED"  wiLl  be  printed  by 
fJp  A . Should  this  happen,  URA  will  not  execute  the  DELETE 
command.  The  command  and  its  parameters  should  be  reentered 


' The  exact  manner  in  which  the  file  is  specified  is  given  in 
Par*  II,  Section  7.2. 
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with  the  necessary  corrections. 

■m  miisisfiaasuirsmi  jccqji 

Nodi f ication  ^ad e 


’’b®  PEl^TE^CONMENT-E  NTRY  takes  those  naaes  specified  as  input 
and  deletes,  for  each  input  naae,  the  conent  entries  associate! 
wi’h  those  coanent  entry  types  designated  as  coaaand 
parameters.*  If  no  coeeent  entry  types  are  specified  by  the 
paraaeters,  no  consent  entries  will  be  deleted.  Checking  is 
performed  to  se*  if  the  comment  entry  exists  in  the  data  base 
before  it.  is  delete!.  If  the  consent  entry  cannot  be  found,  no 
atteapt  is  nade  to  lelete  it. 


Output  Descp  jpt  j on 

The  outnut  report  generated  by  this  coaaand  is  called  DELETED 
COMMENT  ENTRIES.  For  each  coanent  entry  to  be  deleted  froa  the 
data  base,  the  following  inforaation  is  printed  on  the  output: 

- naae  in  the  data  base  to  which  the  coanent  entry  belonged. 

- the  type  of  comnent  entry  (i.e.,  DESCRIPTION,  PROCEDURE,  etc.) 
which  is  being  deleted. 

- ’he  full  text  of  the  conaant  entry. 

The  order  of  the  out  put  naaes  is  the  sane  as  the  orler  of  the 
input  naaes. 

This  serves  as  a hard  copy  record  for  those  consent  entries 
deleted  from  the  systea  description.  As  stated  before,  it  is 
desirable  to  have  all  nodif i cat  ions  to  the  systea  description 
docu  aent  ed. 


Execution 

The  following  command  deletes  the  PROCEDURE  consent  entry 
associated  with  one  naae. 

DCOM  NAME »employee-processina  PROCEDURE 

This  was  done  because  the  problea  definers  wanted  to  delete 
current  PROCEDURE  coaaer.t  entry  and  did  not  want  to  replace  it. 


* An  exaaple  of  a coanent  entry  type  is  a URL  ’•DESCRIPTION"  or 
" "ROCFDU PE"  statenent.  The  coament  entry  associated  with  this 
consent  entry  type  would  he  the  text  specified  by  the  user 
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Tf  »ho  roMont  an^ry  could  h«  correct  if  edited  or  a reolacement 
was  available,  then  it  would  be  more  appropriate  to  use  the 
P EPL  ACE-  CO**!  ENT- ENTRY  command  (see  section  7.8).  The  oitput 
generated  by  this  command  is  shown  in  Figure  8. 


QHiiSDS  iUJ  AliCEDdlilfS 

1)  Multiole  comment  entries  can  be  deleted  for  a naee: 

DC  D M N A V-new-info*  val  id  at  ion  P ROC ED UR F DESCRIPTION 

In  this  case,  the  PROCEDURE  and  DESCRIPTION  comment  entries 
would  be  leleted  for  the  PROCESS,  "new- inf  a- val  idat  ion.  " 

?)  The  following  types  of  comment  entries  can  be  deleted  when 
specified  is  narameters  for  nFLE^E- COMMENT- ENTRY: 

DERIVATION 
DFSCR  TPTION 
” ALSE-Hfiri.F 
PROCEDURE 
" RUE-  NUTT.  E 
VOLATILTTY 
VOLATILITY -NEE  PER 
VO  T.AT  I LI  T Y-SPT 

1)  Several  names  can  have  their  comment  entries  deleted  if  the 
names  are  put  into  a file  and  the  file  is  specified  as 
input.  '"h«»  comment  entries  deleted  for  these  names  are 
thoso  sDori  fiel  as  parameters  for  the  command.  If  the  user 
specifies  that  the  DESCRIPTION  and  PROCEDURE  comment 
entries  be  deleted  for  a CROUP  name,  the  DESCRIPTION 
comment  «ntrv  will  be  deleted  and  the  message: 

UR  A IP  4 : DEL  SET:  PROCEDURE  COMMENT  ENTRY  NOT  FOUND 

will  be  given  because  CROUPS  may  not  have  PROCEDURE 
st  a t emen  ts. 

Figure  u shows  the  output  resulting  from  executing  the 
PPl ETE-CO*M  ENT-FNTRY  command  with  a file  of  names  is  input 
and  DESCRIPTION  and  PROCEDURE  comment  entry  types  as 
parameters.  The  example  shows  for  each  name  used  as  input, 
each  comment  entry  delated  for  the  name. 

4)  Printing  of  the  DFLETpD  COMMENT  ENTRIES  output  may  be 
suppressed  by  specifying  NOPPINT  as  a parameter: 

DCOM  V A*r  = payroll  - processing  DESCRIPTION  NOPRr  NT 
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If  neither  an  input  file  nor  NANS  is  specified  for  the  :onand, 
the  messaqe  "NONAM*  OR  FILE  SPECIFIED"  will  be  printed  by  ORA. 
Should  this  happen,  ORA  will  not  execute  the 

dele TF-roNNFNT-EN'T'PY  command.  The  command  and  its  paraaeters 
should  be  reentered  with  the  necessary  corrections. 


7.  4 DFtFTE-PSJ,  lUPSlil. 


"odi  f ica *ipr]  Nad e 

"his  command  takes  as  input,  any  url  statements  in  the  foraat 
specified  in  the  "User  Pequireaents  Languaqe,  Version  3.2 
Language  Reference  Nanual."1  For  each  section  header  statement 
(i.e.,  PROCESS  n'TINE,  etc,)?  all  the  URL  statements  following 
*his  section  h«M  ler  (up  to  the  next  section  header  statement) 
will  he  deleted  from  the  UPA  data  base  for  those  names  specified 
in  the  header  statement.  This  command  only  deletes 
relationships  betvean  names  and  does  not  delete  any  coaaent 
entries  (this  is  handled  by  the  DCOfl  command)  nor  deletes  names 
(♦■his  is  handled  hy  the  DFLETE  command).  If  some  of  the 
information  presented  by  the  URL  statements  is  contradictory,  an 
error  message  will  be  qiven  for  that  statement.  Error 
diagnostics  are  also  given  when  syntactical  errors  occur.  URA 
attempts  to  continue  the  procedure  until  too  many  errors  are 
encountered. * 


output  D25SCi£tion 

"he  two  outputs  ♦■hat  may  he  generated  by  this  command  are 
DELETED  URL  and  th*  URA  CROSS  RFFERENCE.  The  DELETED  URL  output 
is  a record  of  all  information  (except  names  and  comment 
entries)  deleted  from  the  URA  data  base.  It  aids  the  analyst  in 
finding  errors  in  the  deletion  procedure  and  produces  error 
iiagnostics  in  sufficient  detail  to  aid  the  analyst  in 
correcting  these  errors.  This  output  displays,  line  for  line, 
the  data  used  as  input  to  the  DFLETE-PSL  command.  No  reordering 
is  done  on  the  input  data. 

The  URA  cross  RFPFPENCF  is  intended  as  an  aid  to  the  analyst  in 
correcting  errors  that,  appear  in  the  DELETED  URL  output.  It 
consists  of  an  alphabetical  list  of  all  user  defined  names, 
i.e.,  non-MPI.  names  that  appear  in  the  DELETED  URL  output.  For 
each  name  that  appears  in  the  CROES  REFERENCE,  its  corresponding 
name  typo  (as  given  in  the  DELETED  URL  output)  is  printed  and  a 
list  of  all  lines  in  the  PFLFTEP  URL  output  where  the  name 


1 Part  TI  of  the  URL  User's  Manual. 

* See  Appendix  F of  the  URL  User's  Manual.  List  of  all  possible 
section  header  types. 

a Jim  section  R for  the  limit  of  errors  allowed. 
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appeared  Is  also  given. 


£l*SSii2!l 

Th«»  most  coaeon  act  hod  of  delatinq  URL  statements  is  by  first 
wriMnq  all  statements  to  he  deleted  into  a file  (or  punching 
them  or  cards)  and  then  using  this  as  input  to  the  coaiind.1 
(This  is  usually  done  via  the  INPUT  parameter.)  Only  tha  first 
72  columns  of  each  line  in  the  file  aay  contain  URL  statements. 
Anything  after  column  72  is  ignored.  Figure  10  is  the  output 
resulting  froa  this  type  of  procedure.  The  EOF  statemeat  must 
be  given  tg  specify  the  end  of  URL  statements  to  be  delated. 


QEiians  aai  lltstnaiiiss 

1)  Tr  many  cases  the  amount  of  input  is  relatively  large  (a 
few  hundred  lines);  hence,  there  may  be  a need  for  the  URA 
CROSS  *>  FPEP  ENC  F , It  will  be  generated  by  specifying  the 
XPFP  parameter  with  the  command. 

2)  Tf  no  input  file  is  specified,  UFA  will  wait  for  URL 
statements  to  be  typed  in  (from  the  terminal),  or  when  in 
batch  vode,  interpret  any  following  cards  up  through  the 
first  "EOF"  as  URL  statements  to  be  deleted.  ihen  URL 
statements  are  entered  at  the  terminal,  each  line  antered 
is  echoed  back  by  UFA  along  with  any  errors  encountered  for 
that  statement  (i.  e.  , an  AS-IS  SOURCE  LISTING).  This 
allows  the  us?r  to  correct  errors  as  they  occur. 

i)  Printing  of  tha  DELETED  URL  output  may  be  suppressed  by 
specifying  NOSOURCE  as  a parameter. 


Common  ll£2£s 

The  most  coimon  errors  are  typing  errors  encountered  in 
interpreting  the  UPI.  statements.  A typing  mistake  can  cause 
many  different  types  of  syntactical  and  semantic  errors. 

Only  the  first  72  columns  of  each  line  in  the  input  file  are 
road  so  all  URL  statements  should  fit  in  this  region.  Anything 
over  column  72  will  be  truncated  and  an  error  message  will  be 
generated  in  most  cases. 

omitting  the  semicolon  at  the  end  of  a URL  statement  is  a common 
cause  for  several  errors. 

DFLETF-PSL  will  not  delete  comment  entry  statements  from  the 


1 The  exact  manner  in  which  the  file  can  be  specified  is  given 
in  Part  II,  Section  7.4. 
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.lata  base  si  these  statements  are  ignored  if  encounters!  in  the 
input  file.  No  names  other  than  SYNONYMS  can*be  delete!  from 
♦•he  data  base  via  DFLFTF-PSL. 

The  last  line  of  th°  input  file  containing  the  URL  statements 
should  have  the  word  EOF  signifying  the  end  of  input.  This 
should  also  be  type!  when  inputting  the  data  interactively.  EOF 
allows  the  ceturn  to  the  upa  command  handler.  No  URL  statements 
are  read  after  EOF. 


■».  ' INPMT-PSL  _iX£L 


“2lili£2ii2Q  dade 

^his  command  takes  as  input,  any  URL  statements  in  the  format 
specified  in  "User  Peguirements  Language,  Version  3.2,  Language 
Reference  Manual."*  For  each  section  header  statement  (i.e., 
egocFSS,  DEFINE,  etc.)*  the  user  defined  names  specified  by  that 
section  header  will  be  added  to  the  list,  of  names  in  the  data 
base  (if  not  already  in  the  data  base).  All  the  URL  statements 
following  ♦his  section  header  up  to  the  next  section  header 
s'a'ement,  specify  connections  to  be  made  with  other  names  in 
♦ he  data  base.  upa  first  performs  syntax  and  semantic  checks  on 
each  input  line  before  anv  more  complex  checking  is  performed. 

An  "in  context"  check  is  made  for  each  name  used  as  input.  If 
the  name  is  not  in  the  user’s  data  base,  it  is  added.  Tf  it  is, 
a •'heck  is  aad«  to  see  that  the  context  in  which  the  name  is 
used  in  the  new  input  agrees  with  the  manner  in  which  the  name 
is  used  in  the  data  base.  If  there  is  a conflict,  an  error 
message  will  be  produced  and  'JRA  will  skip  to  the  next  input 
statement,  ura  attempts  to  continue  the  input  procedure  until 
too  many  errors  are  encountered.  * If  redundant  information  is 
liven,  i.e.,  specifying  the  same  relationship  more  than  once, 
the  redundant  information  will  not  be  added  to  the  information 
already  in  th°  data  base.  No  diagnostic  message  is  given  to 
denote  redundant  information. 


2!ilE !*t  Pescr  i pt  i on 

”he  two  outputs  fh.a'  ma v be  generated  by  this  command  are  the 
UPA  AS-TS  SUPPC*  IISTINC.  and  the  URA  CROSS  PEFERFNCE . The  URA 
AS-TS  snupcr  listing  is  a record  of  all  information  input  into 
♦he  TIP  A data  base,  and  is  intended  as  an  aid  to  the  analyst.  It 


* Part  T I of  the  URL  User's  Manual. 

* See  Appendix  p of  the  URL  User's  Manual.  All  possible  section 
header  types. 


* Sp°  Secticn  o for  the  limit  of  errors  allowed. 
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aids  the  analyst  in  finding  errors  in  the  input  data  and 
produces  error  diagnostics  in  sufficient  detail  to  aid  the 
analyst  in  correcting  these  errors.  The  output  displays,  line 
for  line,  the  data  used  as  input  to  the  INPUT-PSL  coaaaad.  The 
order  of  the  input  data  is  not.  changed. 

The  »JRA  CROSS  REFERENCE  is  intended  as  an  aid  to  the  analyst  in 
correcting  errors  that  appeir  in  the  ORA  AS-IS  500RCE  LISTING 
and  also  to  resolve  asbiquities  in  assigning  naae  types  to  the 
undefined  naaes  in  the  listing.  It  is  useful  in  correcting 
errors,  as  any  naae  involved  in  an  error  can  be  quickly 
referenced  to  find  all  places  in  the  AS-IS  LISTING  where  the 
naae  is  used,  and  the  naae  type  assigned  to  that  naae. 

Proa  this  inforaation,  the  analyst  will  be  able  to  deteraine 
what  inforaation  has  to  be  reentered  to  correct  the  error. 

Since  the  CROSS  REFERENCE  also  presents  all  those  naaes  which 
have  an  aabiguous  naae  type  (one  that  was  not  defined  in 
previous  input),  tha  analyst  can  resolve  those  aabiguities  by 
use  of  the  CHANGE-TTPE  or  INPOT-PSL  coaaands.  The  output 
consists  of  an  alphabetical  list  of  all  user  defined  naaes, 
i.e. , non-URL  naaes,  that  appear  in  the  AS-IS  LISTING.  For  each 
naae  that  appears  in  the  CROSS  REFERENCE,  its  corresponding  naae 
typ®  (as  given  in  the  AS-IS  LISTING)  is  printed  and  a list  of 
all  lines  in  the  AS-IS  LISTING  where  the  naae  appeared  is  also 
given. 


nssjtUaa 

■"he  aost  coiaon  aethod  of  inputting  URL  stateaents  is  by  first 
writing  all  stateaents  to  be  added  into  a file  (or  punching  then 
on  cards)  and  then  using  this  as  input  to  the  coaaand.*  (This  is 
usually  done  via  tha  INPUT  paraaeter.)  Note  that  only  the  first. 

?2  coluans  of  each  line  in  the  file  aay  contain  ORL  stateaents. 

Anythinq  after  7 2 is  iqnored.  Figure  11  is  the  output  resulting 
froa  this  type  of  procedure.  The  EOF  stateaent  abst  be  given  to 
specify  the  end  of  URL  stateaents  to  be  added.  The  UPDATE 
paraaeter  soecifies  that  the  mra  data  base  is  to  be  aodified  by 
the  input.  If  this  paraaeter  is  not  qiven,  none  of  the  ^ 

inforaation  will  he  added  to  the  data  base. 


S&U2SI  m2  aiisimiisa 

1)  In  aany  cases,  when  th9  aaount  of  input  is  relatively  large 
(a  few  hundred  lines)  there  aay  be  a need  for  the  IRA  CROSS 
REFERENCE.  Py  siaply  specifying  TREE  as  a paraaeter,  it 
will  he  generated.  Figure  12  presents  an  AS-IS  LISTING  and 
CROSS  REFERENCE  for  h saall  problea  stateaent. 


* The  exact  Banner  in  which  the  file  can  be  specified  is  given 
in  Part  TI,  Section  7,5. 
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2)  In  most  cases,  it  is  advantageous  to  first  do  a syatax  and 
semantic  check  of  the  input  data  before  attempting  to  put 
it  in  the  data  base.  By  not  specifying  the  UPDATE 
parameter,  these  checks  will  be  made  without  actually 
putting  the  information  into  the  data  base.  This  will 
generate  an  AS- IS  LISTING  with  error  diagnostics  far  the 
URL  statements  used  as  input.  Since  most  probLem 
statements  have  one  or  two  typing  errors  anyway,  this 
proves  to  h®  an  inexpensive  way  to  catch  errors  early. 

After  the  source  of  the  errors  has  been  determined  and 
corrected,  the  command  can  be  issued  again  using  UPDATE  as 
a parameter . 

1)  Tf  no  inout  file  is  specified,  UFA  will  wait  for  URL 

statements  to  be  typed  in  (from  the  terminal),  or  when  in 
batch  mode,  interpret  any  following  cards  up  through  the 
first  "EOF"  as  URL  statements  to  be  added  to  the  data  base. 
When  hr l statements  are  entered  at  the  terminal,  each  line 
entered  is  echoed  back  by  URA  along  with  any  errors 
encountered  for  that  statement  (i.e.,  an  AS-IS  SOURCE 
LISTIN'?)  . This  allows  the  user  to  correct  errors  as  they 
occur. 

4)  Printing  of  the  AS-IS  SOURCE  LISTING  may  be  suppressed  by 
specifying  NOSOURCE  as  a parameter. 

F)  The  DBF F ? parameter  allows  referencing  of  the  data  base 

when  semantic  as  well  as  syntax  checks  are  desired  for  URL 
statements  used  as  input.  This  must  be  in  effect  when 
UPT ATS  is  given  as  a parameter.  NODBREP  may  be  specified 
if  only  a syntax  check  of  the  statements  is  desired  and  the 
data  base  is  not  to  be  updated. 


I 


Common  Errors 

The  most  common  errors  are  typing  errors  encountered  in 
interpreting  the  UP L statements.  A typing  mistake  can  cause  so 
many  different  types  of  syntactical  and  semantic  ercors  that  it 
will  be  handled  in  a later  section  (section  10). 

It.  is  also  possible  to  input  the  new  information  into  the  wrong 
data  base.  It  is  important  that  the  data  base  to  be  used  has 
b®en  specified.  otherwise,  the  data  base  may  be  set  to  some 
default,  which  may  not  he  the  data  base  file  desired. 


The  INPUT-PSL  command  only  reads  the  first  72  columns  of  each 
line  in  the  input  file  so  all  URL  statements  must  fit  in  this 
region.  Anything  over  column  72  will  be  truncated  and  an  error 
m®ssaqe  will  be  given  in  most  cases. 


Omitting  the  semicolon  at  the  end  of  a URL  statement  is  a common 
cause  for  several  errors.  It  is  important  that  the  syntax  of 
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each  UFL  statement.  he  correct. 

The  last  line  of  the  input  file  containinq  the  URL  statements 
should  have  the  word  EOF  signifying  the  end  of  input.  This 
should  also  be  typed  when  inputting  the  data  interactively.  EOF 
allows  the  return  to  the  URA  coeeand  handler.  (See  Figures  11 
and  1?  to  see  how  EOF  is  used  correctly.)  No  URL  statements  are 
read  after  EOF. 


7.*  !K2flL 


flodj  f ica  t jog  Fade 

Technically,  the  output  produced  hy  this  command  is  a report 
presenting  narrative  information  in  the  manner  of  a glossary. 

Tt  makes  no  modifications  to  the  data  base,  but  is  presented 
here  because  its  main  objective  is  to  aid  the  analyst  in 
changinq  comment  entries  in  conjunction  with  the 
REPLACE-  CONE  ENT  - ENTRY  command.  The  idea  of  using  the  output,  as 
a glossary  (for  final  specifications  perhaps)  however,  should 
not  be  overlooked.  A message  is  given  when  no  comment  entry  is 
available  for  a particular  comment  entry  type  or  the  name 
specified  is  not  in  the  data  base. 


QalEili  J}£22Li£!i2J! 

The  PUNCHED  CORE PNT  ENTRIES  output  is  generated  hy  this  command. 
Tt  presents  selected  comment  entries  for  each  name  used  as  input 
to  the  command.  Any  type  of  name  may  be  used  as  input  to  the 
command.  Depending  on  the  type  of  name  the  following  comment 
entries  may  be  retrieved: 


DERIVATION 

(DER) 

DESCRIPTION 

(DESC) 

PALSE-WHILF 

(FW) 

PROCEDURE 

( PRCD) 

TP  UP-WHILE 

(TN) 

VOLATILITY 

(VOL) 

VO  LATI  LITY  - NEH  HER 

(VOLF) 

VOLATILITY-SET 

(VOLS) 

*or  each  nave  used  as  input  to  the  command,  the  name  is  printed 
on  the  output  in  the  order  in  which  it  was  read  and  associated 
with  that  name,  the  type  of  comment  entry  and  the  to*t.  for  that 
comment,  entry  (for  each  type  of  comment  entry  as  specified  in 
the  parameter  list.). 


BsasnUsn 

To  obtain  the  DESCRIPTION  comment  entry  for  one  name  th» 
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following  command  miqht  he  given: 

PCOM  NAMP = pay roll -processing  DESCRIPTION 

This  will  generate  the  report  shown  in  Figure  13.  A PUNCH  file 
will  also  he  generated  with  the  saee  information  as  the  report, 
’’’he  manner  in  which  the  file  to  contain  the  PUNCH  data  is 
specified  is  installation  dependent  and  given  in  Part  II, 

Section  7.6.  If  the  procedure  is  done  at  the  terminal,  the 
PUNCH  file  can  then  be  edited  and  used  as  input  to  the 
REPLACE- COMM  ENT-ENTRY  command  to  Modify  the  convent  entry.  If 
th°  procedure  is  done  in  batch,  the  contents  of  the  PUNCH  file 
produced  should  he  punched  on  cards  (by  the  system  if  possible). 
”hen  the  deck  of  cards  produced  can  be  modified  and  used  as 
input  to  PEPLACE-CDMM ENT-FNTRT  in  the  next  batch  run. 


Options  and  Alternatives 

1)  Several  names  can  have  comment  entries  printed  and/or 
PUNCHED  if  the  names  are  put  into  a file  and  the  file  is 
specified  as  input  to  the  command.1  (This  is  usually  done 
via  the  PILE  parameter.)  Figure  1U  is  an  output  resultinq 
from  using  a file  as  input  to  the  PCOM  command. 

2)  Multiple  comment  entries,  such  as  DESCRIPTION  and 
PROCEDURE,  can  be  generated  for  several  names  when  a file 
is  SDPoified  as  input  and  more  than  one  comment  entry  type 
is  specified  as  parameters.  This  is  illustrated  in  Figure 
1*>. 

When  the  objective  of  executing  this  command  is  to  generate 
a PUNCH  file,  printing  of  the  report  may  be  suppressed  by 
issuing  noppivT  as  a parameter. 

U)  When  the  objective  of  executing  this  command  is  to  generata 
the  report  (and  no  PUNCH  data  is  desired) , production  of 
data  in  the  PUNCH  file  may  be  suppressed  by  issuing  N0PUNC1 
as  a parameter. 

c‘)  The  NAME-TEN  can  also  be  used  in  conjunction  with  PCOM  to 
retrieve  all  names  of  a particular  name  type  (such  as 
INTERFACE)  to  lie  used  as  input  to  the  PCOM  comiand.  For 
example : 

NAME-GEN  S= • INTER  PACE • 

PCOM  DESCRIPTION 

This  procedure  retrieves  all  INTERFACE  names  defined  in  the 
data  base  and  produces  the  PUNCHED  COMMENT  ENTRIES  report 


1 The  exact  manner  in  which  the  file  is  specified  is  qiven  in 
Part  TI,  Section  7.6. 
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for  all  these  naaes  and  their  corresponding  DESCRIPTIONS. 
This  could  also  be  done  for  Bore  than  one  type  of  naae: 

HA  ME -(JEN  Sa'  SET  OP  PROCESS' 

PCOM  DESCRIPTION  PROCEDURE 


Notice  that  the  PROCEDURE  paraaeter  is  given,  but  SETS 
cannot  have  PROCEDURE  stateaent.s  associated  with  than. 

Only  the  description  stateaents  will  be  retrieved  for  SET 
naaes  while  both  DESCRIPTION  and  PROCEDURE  statements  will 
be  retrieved  for  PROCESS  naaes. 


Common  Fx£2E£ 

The  problea  definer  should  note  that  aost  of  the  paraaeters 
indicating  coaaent  types  (i.  e. , EALSE-WHILE,  VOLATILITY,  etc.) 
can  apply  to  only  one  type  of  naae  (CONDITION,  ENTITY, 
respect i vel y)  . 


7 RENAME  IRENL 


Modification  Made 

The  RENAME  coaaand  takes  an  old  naae  (of  soae  object  in  the 
problem  statement  data  base)  and  a new  naae  as  input.  If  the 
new  naae  is  not.  a URL  reserved  word  or  a naae  already  in  the 
data  base,  the  command  will  replace  the  old  name  by  the  new 
name.  Refore  a name  is  changed,  URA  checks  that: 

- the  old  name  exists  in  the  data  base. 

- the  pew  name  is  not  already  used  in  the  data  base. 

- the  new  naae  is  a legal  nRL  name  (see  the  "User  Requirements 
Language,  Version  3.2  Language  Reference  Manual").1 

If  any  of  these  requirements  are  violated,  no  change  will  be 

made. 


c, 

1 


I 

I 

) 

I 


2 lit 2 Hi  Descc  jotjon 

The  output  generated  from  this  command  is  called  the  RENAME 
REPORT.  For  everv  name  changed  by  the  RENAME  coaaand,  this 
report  presents  th®  "old  naae"  which  appeared  in  the  data  base 
and  the  "new  name"  which  has  taken  its  place.  When  the  name 
change  is  not  successful,  error  diagnostics  are  also  printed 
specifying  the  cause  of  the  error.  Again,  the  aaaes  art  printed 


* Part  II,  URL  Manual 
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on  t hp  output  in  the  sane  order  as  they  are  read  as  input. 


Execution 

To  change  one  name  in  the  data  base,  the  following  command  night 
he  given: 

F ENAM F TL n=om ploy  ee- ident if icat ion-number  NEV= employs e- id 
Unon  first  defining  the  tarqet  system, 

"emplovee-i.1  enf  i f ica  t ion-nun  ber " was  used  to  represent  1 certain 
piece  of  da^a.  Latar  it  was  found  that  this  data  was  actually 
called  "employee-id"  and  the  change  was  made  to  be  consistent 
with  organization  terminology.  See  Figure  16  for  the  report 
generated  hy  this  conmand.  This  connand  is  also  beneficial  for 
chanqinq  misspelled  names  in  the  data  base.  Through  typinq 
errors,  "employee-number"  may  have  gone  in  as  "emplyee-a uber ", 
This  mistake  can  he  corrected  by: 

RFNAMF  OLD= emplyee- n uber  NEW=employee-number 


Opt  j ons  and  Alternatives 

As  with  most  of  the  modifier  commands,  the  problem  defiaer  has 
the  option  of  changing  several  names  at  one  time.  The  old-new 
name  pairs  must  first  be  put  in  a file  to  be  used  as  input  to 
the  command.  (This  is  usually  done  via  the  INPUT  parameter.) 
Figure  17  presents  the  output  resulting  from  this  procedure. 

Each  line  of  the  file  must  consist  of  an  old  name  followed  by 
the  corresponding  new  name.  The  two  names  may  be  anywhere  in 
the  first  flD  columns  of  the  line  and  must  be  separated  by  one  or 
more  blanks.  The  format  of  the  file  used  to  produce  Figure  17 
is  qiven  below: 

em  ploy ee- inf or  mati on  paysystem- i nputs 

employee  personnel 


Common  Errors 

The  most  common  error  in  usinq  RENAME  is  specifying  a name 
already  in  the  data  base  or  a URL  reserved  word  as  the  new  name. 
Up A will  not  make  the  change  if  this  is  the  case.  The  command 
would  have  to  be  reissued  with  another  new  name  to  take  the 
place  of  the  illegal  one. 

Tf  neither  an  input  file  or  an  OLD/NEW  pair  of  parameters  is 
specified  for  the  command,  the  message:  "MUST  GIVE  OLD  AND  NEW, 
OR  INPUT"  will  be  printed  by  UR  A.  Should  this  happen,  ORA  will 
not  execute  the  RENAME  command.  The  command  and  its  parameters 
should  be  reentered  with  the  necessary  corrections. 
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7.  3 PIPtiSEiCOMJSjr^FJlIRX  IPCOfll 


32lili£2ii2!l  n«ie 

■'•his  command  ♦,alu»s  as  incut  napes  which  exist  in  the  data  base, 
each  followed  by  a U»L  content  entry  stateaent.  If  the  consent 
is  a DESCRIPTION  cniient  entry,  for  exanple,  then  the  command 
will  replace  the  oil  DESCRIPTION  consent  entry  by  the  one  used 
as  input.  Hhat  RCON  actually  does  is  delete  the  old  coanent 
<»ntry  and  put  the  new  consent  entry  in  its  place.  This  is  done 
after  a check  has  been  aade  to  ascertain  that  the  "eld  consent 
entry"  exists  in  the  data  basa  and  the  "new  consent  entry"  is 
legal  for  the  particular  application  beinq  used  (e.g.,  lot 
attemptinq  to  enter  a PROCEDURE  connent  entry  for  a SET  nase) . 

A check  is  aade  to  see  if  the  input  nase  is  in  the  data  base. 

Tf  an  attenot  is  male  to  replace  a consent  entry  for  a nase  that 
did  not  have  a consent  entry  specified  for  it,  the  sassage: 

MPA  12f-  :RFP  SE’r:  WARNIN';  - THERE  IS  NO  COMMENT  ENTRT  TO  DELETE 

will  be  qiv»n  and  the  designated  consent  entry  will  be  connectel 
to  the  nase. 


Output  Description 

The  output  generate!  by  this  report  is  called  REPLACED  COMMENT 
'!,V"eIES.  p5r  "old  comment  entry"  to  be  replaced,  the 

output  depicts,  in  the  following  order: 

- name  to  which  tha  "old  comment  entry"  belongs. 

- the  type  of  coanent  entry  which  is  being  changed. 

- the  entire  text  of  the  "old  consent  entry." 

- the  entire  text  of  the  "new  coanent  entry"  which  replaces  the 
old  one. 

®rror  diagnostics  referring  to  problens  encountered  in  executing 
the  command  ar°  also  printed  here. 


SSfSUtign 

Anv  inforsation  tn  he  supplied  as  input  to  RCON  nust  first  be 

* The  exact  manner  in  which  the  file  is  specifibd  is  giren  in 
Part  IT,  Section  7.  R. 
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placed  in  a file  and  the  file  must,  he  desiqnated  as  input.* 
(This  is  usually  done  via  the  INPUT  parameter.) 

’'h*  contents  of  the  file  must  be  in  the  following  format: 

nar  e 

comment  en*rv  type; 

m 

m 

com  m en  t en  t r y 


• : 
etc. 

■"he  contents  of  ♦■he  file  used  to  produce  the  output  shown  in 
figure  1*  was: 

new-employee-process inq  DESCRIPTION;  This  process  produces  the 
new  hire  section  in  the  h-t  report.;  new-employee-processing 
PROCEDURE;  1.  add  new  employee  information  2.  increment  count 
of  number  of  employees  in  appropriate  department  3.  specify 
relationship  between  employee  information  and  department  4. 
Initialize  all  appropriate  fields  in  employee  information.  5. 
Print  the  new  hire  section  of  the  h-t  report.; 


Options  and  Alternatives 

1)  It  is  often  the  case  that  only  some  minor  editing  of  a 
comment  entry  need  be  done  to  make  it  correct.  This  can  be 
done  when  the  output  from  the  PnNCH- COMM  ENT- ENTR  T command 
is  edited  and  used  as  input  to  the  PCON  command.  This  is 
described  in  section  7.6  of  this  paper. 

2)  To  suppress  printing  of  the  REPLACED  COMMENT  ENTRIES  report 
the  N3PRINT  parameter  may  be  specified. 


Common  Errors 

The  malor  problem  in  using  this  command  is  specifying  the  file 
format  correctly.  (This  is  not  a problem,  however,  if  the 
contents  of  the  file  used  was  produced  by  pnNCH-COMH  ENT- ENTRY . ) 
Although  the  command  allows  free  formatting  of  the  file,  the 
order:  name,  comment-entry  type,  comment-entry  must  be 
maintained.  Each  must  begin  on  a new  line. 


d.  R*POPT  COMMANDS 


Report  commands  retrieve  specific  types 
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data  base  and  present.  it  in  formats  which  aid  the  problem 
d»finer  to  analyze  the  problem  statement  for  correctness  and 
completeness.  Many  of  the  formats  can  serve  as  final 
specifications  of  the  system  being  designed. 

Most'  report  commands  allow  the  report  to  be  generated  for  a 
single  name  (via  the  NAME  parameter)  or  for  a number  of  names 
placed  in  a file  and  specified  as  input  to  the  command.1 

’’’he  descriptions  of  these  report  commands,  their  usage  and 
interpretation,  and  the  usage  of  reports  produced  by  them  are 
given  in  "UR A Outputs. "* 


U.  "PROP  DIAGNOSTICS 

URA  has  extensive  oheckino  facilities  to  prevent  errors  in  the 
problem  statement.  At  the  URA  command  mode  level,  checks  are 
made  to  insure  that  all  commands  given  are  legal  URA  coamands 
and  that  all  parameters  given  are  legal  parameters  for  that 
command.  If  an  illegal  command,  an  illegal  parameter,  or 
illegal  parameter  for  that  command  is  given  when  in  on-line 
mode,  the  following  message  will  he  generated: 

INVALID  PARAMETER  - 
ENTER  REPLACEMENT  OR  BLANK  LINE 
■» 


The  user  must  enter  the  replacement  following  the  question  mark 
and  then  hit  t.hQ  carriage  return  key.  If  the  command  is 
accepted,  processing  of  that  command  commences.  Should  an  error 
ho  encountered  while  processing  the  command,  one  of  the 
following  three  tvnes  of  error  diagnostics  will  be  given: 


i)  Data  Rase  Management  System  Errors 

Th°se  errors  are  encountered  when  there  may  be  some  danger  of 
destroying  the  contents  of  the  URA  data  base  or  there  is  an 
error  in  the  rjPA  software.  Even  though  the  URA  software  might 
be  the  cause  of,  the  error,  it  is  doubtful  if  it  will  do  anything 
to  harm  the  contents  of  the  user's  data  base.  A complete  list 
of  these  error  messages  is  given  in  "A  Data  Base  Management 
System  for  UFA  Based  on  DBT3  71." 

***  ERROP  16  - DATA  BASE  FILE  INCON  SISTENT 

This  error  message  is  given  if  the  user  attempts  to  modify  or 
retrieve  information  from  a URA  data  base  which  has  had  its 


* The  exact  manner  in  which  this  is  done  is 
installation-dependent  and  is  given  in  Part  IT,  Section  B. 

* Part  TIT 
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rnnten's  altered  so  that.  it  is  unusable  by  the  URA  software. 

***  ERROR  » n FOUND  IN  ROUTINE  » ■ 

An  «rror  message  of  this  format  usually  designates  an  error  in 
♦■he  UFA  software,  where  n is  the  error  number.  To  find  out 
which  routine  th<>  error  occurred  in,  refer  to  "A  Data  Base 
Management  System  for  UFA  Based  on  DBTG  71."  If  the  values  of 
the  variables  n and  n are  15  and  1C  respectively,  the  error 
desiqnat.es  a la'a  base  inconsistency  which  is  usually  a user 
jrror.  Anv  other  errors  of  this  form  with  different  values 
should  be  brouqht  to  the  attention  of  those  persons  maintaininq 
♦he  UFA  software. 


ii)  'IRA  Command  Errors 

These  errors  are  encountered  in  the  processing  of  URA  commands 
anl  are  user  errors.  These  diaqnostics  are  generated  when  the 
ns>»r  presents  ambigious  or  incorrect  information  to  the  URA 
commands.  In  mos*-  cases,  URA  will  take  no  action  to  fulfill  the 
user's  request  if  an  error  is  encountered.  The  command  must  be 
restated  in  corrected  form,  before  action  is  taken.  All  these 
errors  are  presente!  in  the  following  format: 

q RAnnn isubrout ine:  error- messaqe 

where  "nnn"  designates  the  UFA  error  number,  "subroutine" 
denotes  the  subroutine  in  the  UFA  software  where  the  error 
occurred,  aid  "»rror - messaqe " corresponds  to  some  diaqnostics 
which  describe  the  error  condition. 


iii)  UFA  Input  Errors 

Th eso  errors  are  encountered  when  the  INPUT-PSL  or  DELETE- PSL 
are  used  incorrectly.  UFA  alwavs  attempts  to  recover  from  these 
errors  unless  an  excessive  number  of  errors  have  been 
encountered.  pich  of  these  errors  is  assigned  a level  number,  1 
through  4.  Th°  user  is  allowed  to  make  up  to  24  level  1 and  24 
level  2 errors,  but  a sinqls  level  1 or  level  4 error  will 
t°rminat.e  processing  of  the  command.  The  levels  are  described 
below. 


Level 

Desc riot  ion 

Limit 

1 

This  statement  is  ignored. 

94 

2 

Serious  user  error 

24 

1 

UFA  unable  to  recover 

0 

4 

Fxceeded  UFA  capabilities 

0 

These  types  of  errors  are  presented  in  the  following  format: 
***•  LEVEI  1,  UR A nnn : subrout ine : orro r-m essage 


1 


H6180/Multics/UPA  User’s  Manual 


where  "I"  designates  the  level  number  and  "nnn"  denotes  the  URA 
error  number.  The  last  part  of  the  format  is  the  same  as  the 
H»A  command  errors. 

After  processing  any  UFA  command,  a STOP  status  message  is 
given.  This  message  designates  that  processing  of  the  command 
was  successful  (ST^P  0,  i.e.  , errors  were  handled  effectively, 
etc.)  or  that  processing  was  not  totally  successful  (STDP  4 or 
‘'Top  B)  . STOP  4 is  qiven  when  an  error  level  limit  is  exceeded 
for  TMPUT-PSL  errors,  for  example.  The  STOP  8 message 
designates  a serious  error  in  attempting  to  access  the  data 
hasp,  usually  resulting  from  an  inconsistent  data  base. 

The  following  is  a list  of  all  possible  errors  that  can  be 
encountered  while  using  URA.  a short  description  of  each  error 
accompanies  it.  as  w»ll  as  suggested  action  to  take  should  the 
°rrnr  occur.  More  than  one  error  may  have  a siiilar 
exolanation,  while  the  software  makes  a distinction  because  the 
error  is  recognized  in  different  places. 
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2ii!5!2S£  Subroutine  Error  Message 


2 NL^X 


3 NT."* 


U INDSS 


NAME  TOO  LO NR 

A user  defined  na ne  has  exceeded  the  30 
character  limit  allowed  by  URL/UR  A.  The 
name  is  truncated  to  30,  but  is  still  put 
in  the  data  base.  (See  section  10.1, 
part  v.) 

•EOF*  NOT  FOUND  BEFOPF  EN  D-OF  - FILE 
The  user  has  terminated  the  input  before 
specifying  the  HR  L 'EOF'.  Processinq  of 
the  input  is  terminated. 

ERPOP  OPENING  DATA  BASE  FOR  - 


NLEX 


* SCAN 


1 SCAN 


COMLOP 


0 PROK 


10  REDUC* 


END-OF-FILF  IN  MIDDLE  OF  COMMENT 
The  end  of  input  has  been  encountered 
followinq  the  '/*•  comment  characters. 
Processinq  of  the  input  is  terminated. 

INVALID  LEXICAL  TYPE  RETURNED  FROM  NLEX 
UFA  software  error.  Please  notify 
persons  maintaininq  URA  should  this  error 
occur  . 

ILLEGAL  CHARACTER  - IGNORED 
An  illeqal  chAract^r  encountered  when 
scanninq  an  input  line.  See  the  "User 
Requirements  Lanquage,  Version  4.0 
Lanquage  Reference  Manual”  for  a complete 
list  of  legal  characters.  The  illeqal 
character  is  ignored  and  processinq  of 
the  UPL  statement  continues. 

PARSE  STACK  OVERFLOW 
UFA  software  error.  Please  notify 
persons  maintaininq  URA  should  this  error 
occur . 

BAD  CASE 

URA  software  error.  Please  notify 
persons  maintaininq  URA  should  this  error 
occur . 

NO  APPLICABLE  PRODUCTION  - SYNTAX  ERROR  - 
START  SKIPPING 

Illegal  UPL  statement  syntax  is 
encountered.  If  this  is  a header 
statement,  followinq  statements  will  be 
assigned  to  the  previous  header 
statement.  The  error  may  be  a result  of 
incorrect  usaqe  of  a URL  reserved  word. 
(See  section  10.1,  part  i.) 


°art  I User  Requirements  Analyier 





HfilBC/nul  tics/URA  user's  Manual 


43 


11  STUCK 


12  ISYNBL 

1.1  ISTMBL 

14  SETT  PE 

15  STUCK 

15  COM1!  NT 

17  SKIP 

1 5 FETCH 

14  RECDV 

23  RFCDV 

21  SET  I MF 


ILLEGAL  SYMBOL  PAIR  - SYNTAX  ERROR  - 
STAPT  SKIPPING 

Illegal  URL  statement  syntax  is 
encountered.  If  this  is  a header 
statement,  following  statements  will  be 
assigned  to  the  previous  header 
statement.  This  statement  is  not  entered 
into  the  UFA  data  base.  (See  section 
10.1,  part,  i.) 

SYMBOL  TABLE  OVERFLOW 
Exceeded  limits  of  URA.  Reissue 
I V PUT -P ST,  command  at  point  in  the  input 
file  where  this  error  occurred. 

TOO  MANY  SYMBOLS 

Exceeded  limits  of  URA.  Reissue 
INPUT-PSL  command  at  point  in  the  input 
file  where  this  error  occurred. 

INVALID  SYMBOL  TABLE  POINTER 
URA  software  error.  Please  notify 
persons  maintaining  URA  should  this  error 
occur . 

INVALID  CASE 

URA  software  error.  Please  notify 
persons  maintaining  URA  .should  this  erroc 
occur . 

END-D  F- FILE  IN  COMMENT  ENTRY 
End  of  input  encountered  in  URL  comment 
entry.  Processing  of  the  input  is 
te  rmi na  ted . 

END  OF  FILE  WHILE  SKIPPING 
Serious  error.  In  attempt  to  recover 
from  nrevious  errors  the  end  of  input  has 
been  encountered.  Processing  of  input,  is 
termi na  ted . 

PROCESS  HAS  NO  RESOURCE  USAGE  - 

UNABLE  TO  RECOVER  AT  THIS  TIME 
Processing  of  input  is  terminated  due  to 
serious  prrors  which  make  it  unable  to 
continue. 

LAST  STATEMENT  SKIPPED 

Statement  where  error  occurred  is  skipped 
so  that  processing  of  input  may  continue. 

INVALID  SYMBOL  TABLE  POINTER 

URA  software  error.  Please  notify 


■ i 
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22 


23 

2« 

?S 


2* 


27 


2R 


2U 


30 

31 


32 


RWLTS2 


updtps 

MAIN  RCOM 

HEAD 


igty  pe 


PTABIN 


PTABIN 


MAINCT 


UPDTPS 

MAINCT 


HAINC’’’ 


persons  maintaining  URA  should  this  error 
occur . 

SAKE  ATTRIBUTE  ALREADY  GIVEN  WITS 
DIFFERENT  ATTRIBUTE  VALUE 
An  attempt  was  made  to  assign  a second 
value  to  the  same  ATTRIBUTE  for  a given 
name.  The  new  value  is  ignored. 

OVERFLOW  IN  RESOURCE  STACK  --  CONTINUING 

MISSING  SEMICOLON  ON  LINE  AFTER  NAME 
Semicolon  is  needed  to  terminate  comment 
entry  statement. 

INVALID  HEADER  STATEMENT  - STATEMENTS 
WILL  BE  IGNORED 

Illegal  syntax  of  header  statement.  All 
URL  statements  up  to  the  next  header 
statement  will  be  ignored.  (This  error 
is  also  described  in  section  10.1,  part 
iii.) 

INVALID  SYMBOL  TABLE  POINTER 
URA  software  error.  Please  aot  ify 
persons  maintaining  URA  should  this  error 
occur . 

INVALID  LEXICAL  TYPE  OR  END-OF-PILE 
URA  software  error.  Please  notify 
persons  maintaining  URA  should  this  error 
occur . 

DUPLICATE  RESERVED  WORD  - IGNORED 
URA  software  error.  Please  notify 
persons  maintaining  URA  should  this  error 
occur . 

CONFLICT  WITH  EXISTING  DATA  BASE 
CONNECTIONS 

Attempt  made  to  change  name  type  to  one 
which  conflicts  with  the  context  in  which 
the  name  is  used.  No  change  is  aade. 

NO  MEASURES  INFORMATION  FOR  RESOURCE  - 

BAD  INPUT  FORMAT 

The  format  of  the  file  used  as  input  to 
the  command  is  incorrect.  See  the 
command  description  for  correct  format. 

No  change  is  made. 

NAME  NOT  IN  DATA  BASE 

Atteapt  to  change  name  type  of  name  not 
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33  BAINCT 

14  BAINCT 

35  BAINCT 

36  BAINCT 

37  DPDTRS 

33  HAINRFV 

33  HAINRFN 

43  CLRFN 

41  FAIN  DSL 

42  BAIN  DSL 

43  OTHERS 

44  OTHERS 


defined  in  the  URA  data  base. 

INVALID  NAME  TYPE 

Attempt  to  assign  an  illegal  name  type  to 
a name.  Probably  a spelling  error. 

NABE  TYPE  TOO  LONG 

Attempt  to  assign  an  illagal  naaa  type  to 
a name.  Probably  a spelling  error. 

BANNING  - STUFF  AFTER  NAME  TYPE 
The  input  file  contains  lore  than  lust 
naae  and  new  naae  type.  The  extra  data 
will  be  ignored  by  the  coaaand  processor. 

INVALID  NABE  - TOO  LONG 
The  naae  for  which  the  change  is  to  be 
made  is  over  30  characters.  Check 
spell ing. 

OVERFLOW  IN  INFORMATION  STACK  - 
CONTINUING 

OLD  NABE  NOT  IN  DATA  BASE 
Atteipt.  to  change  name  of  soae  object 
which  is  not  defined  in  the  data  base. 
Probably  a speilinq  error. 

NEW  N AH  F ALREADY  IN  DATA  BASE 
Attempt  to  change  old  naie  to  a naae 
already  defined  in  the  data  base.  User 
■ ust  choose  another  naae. 

BUST  GIVE  OLD  AND  NEW,  OR  INPUT 
Paraaeters  given  for  the  command  do  not 
suppLy  sufficient  information  for 
processing.  Reissue  command. 

NAM*  TO  BE  DELETED  NOT  IN  DATA  BASE 
Attempt  to  delete  a name  which  is  not 
defined  in  the  URA  data  base. 

INVALID  BERBER  TYPE 
URA  software  error.  Please  notify 
persons  maintaining  URA  should  this  error 
occur . 

CARDINALITY  ALREADY  GIVEN  AS  SYSPAR 
Attempt  to  assign  a numerical  value  to  a 
CARDINALITY  statement,  when  previously 
assigned  a SYSTFH-P.AR  AHETER  name.  The 
value  is  ignored. 

CARDINALITY  ALREADY  GIVEN  AS  DIFFERENT 
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VALUE 

Attempt  to  assign  a second  value  to  a 
CARDINALITY  statement.  The  new  value  is 
iqnored. 

4 S CLCT  NO  TYPE  RIVEN  WITH  "N  AHE="  OR  "PILE" 

PARAMETER 

No  new  nane  type  has  been  specified.  The 
connand  must  be  reissued. 

4 S CT  TYPE,  B U'*'  NO  NAME  OR  FILE  GIVEN 

No  naee  has  been  specified  to  have  its 
name  type  changed.  The  NAME  or  PILE 
parameter  eust  be  given. 

47  PRERCA  INTERVAL  NOT  POUND  IN  DATA  BASE  - 

44  PRERCA  KEYWORD  NOT  POUND  IN  DATA  BASE  - 

4 0 CNUM  RT  NO  NAMES  IN  DATA  BASE 

Attempt  to  retrieve  nanes  froe  an  eepty 
data  base. 

BO  PLIST  TOO  MANY  NAMES  - REST  IGNORED 

Exceeded  5C  name  linit.  Regaining  naaes 
should  be  qiven  in  another  statement. 

51  RWLIST  MUST  BE  SUPSETTING  CRITERION  NAME 

Attempt  to  define  a name  which  is  not  a 
GROUP  or  ELEMENT  to  be  SUBSETTING 
CRITERION. 

52  IDENTC  NAME  NOT  IN  DATA  BASE 

Attempt,  to  retrieve  inforaation  about  a 
name  which  is  not  defined  in  the  data 
base. 

53  OP^PW  NAME  LIST  TOO  LONG  - REST  IGNORED 

Exceeded  SC  naae  linit.  Reaaining  naaes 
should  be  qiven  in  another  stateient. 

S'4  UPDTPR  PROCESS  HAS  NO  PROCESSOR  - 

SS  UPDTPR  OVEPPLOW  IN  PROCESSOR  STACK  - MUST  ABORT 

SB  UPDTPR  NO  HAPPENS  INFORMATION  FOR  - 

S7  FETCH  SYSTEM  PARAMETER  HAS  NO  VALUE  - 

SB  "NDRUP  NO  PROCESSOR  INFORMATION  FOR  - 

SO  PPEPRO  ROOT  PROCESS  NOT  POUND  IN  DATA  BASE  - 

S3  APPLES  SECOND  MAILBOX  FOR  PD  ILLEGAL 
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61  RWLTST 


62  RWLTST 


61  RWLIST 


6U  MATNDIC? 


66  MAINCONT 


66  HATNPIC 


67  MAIN  PIC 


68  REPSET 


Attempt  to  associate  a second  MAILBOX  to 
a particular  PROBLEM  DEFINER. 

ALREADY  PART  OF  SOMETHING  ELSE 
Atteapt  to  define  a structure  whare  an 
object  is  PART  OF  wore  than  one  other 
object.  This  is  contrary  to  rules 
specified  in  the  "User  Requirements 
Language,  Version  3.2,  Language  Reference 
Manual . 


SECOND  PD  FOR  THIS  ITEM  ILLEGAL 
Atteapt  to  assign  a second  RESPONSIBLE- 
PROPL  EM-DFFTNER  to  an  object.  This 
statement  is  ignored. 


ALREADY  PART  OP  SOMETHING  ELSE 
Atteapt  to  define  a structure  where  an 
object  is  PART  OF  more  than  one  other 
object.  This  is  contrary  to  rules 
soecified  in  the  "riser  Requirements 
Language,  Version  3.2,  Language  Reference 
Manua l . " 1 

NAME  NOT  FOUND  IN  DATA  BASS 
At  tew  pt  to  retrieve  information  about  a 
name  tha*  is  not  defined  in  the  lata 
base. 


NAME  NOT  FOUND  IN  DATA  BASE  - 
Att.eipt  to  retrieve  information  about  a 
name  that  is  not  defined  in  the  lata 
base. 


NAME  NOT  IN  DATA  BASE 

Atteapt  to  retrieve  information  about  a 
name  that  is  not  defined  in  the  lata 
base. 


PICTURE  NOT  AVAILABLE  FOR 

Attempt  to  generate  the  report  for  a name 
which  is  not  a SET,  INPUT,  OUTPUT, 

ENTITY , GROUP,  ELEMENT,  PROCESS  jr 
INTERFACE.  Only  these  types  of  objects 
may  have  PICTURES  generated  for  them. 

WARNING  - MISSING  SEMICOLON.  NED  COMMENT 
ENTRY  ADDED 

Semicolon  not  given  to  terminate  comment 
entry.  One  is  assumed  and  processing 
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cont i nues. 


PEPS  FT 


NO  NEW  COMMENT  ENTRY  - OLD  ENTRY  HAS  BEES 
DFLETED 

Sinca  no  new  comment  entry  has  baen  given 
to  replace  the  old,  the  old  comment  entry 
statement  is  deleted. 


CLDCOM 


NO  NANS  OR  FILE  SPECIFIED 
Either  the  NAME  or  FILE  parameter  must  be 
given  for  this  command  to  be  executed. 
Parameters  qiven  do  not  supply  sufficient 
information  for  processing.  Reissue 
comrnan  d . 


CLOT 


PARAMETER  LEGAL  ONLY  IN  MTS  VERSION  - 


CLOON" 


PARAMETER  LEGAL  ONLY  IN  MTS  VERSION  - 


PARAMETER  LEGAL  ONLY  IN  MTS  VERSION 


PARAMETER  LEGAL  ONLY  IN  MTS  VERSION  - 


CLFPS 


PARAMETER  LEGAL  ONLY  IN  MTS  VERSION  - 


MAIN  PRTO 


NAME  NOT  IN  DATA  BASE 

Attempt  to  retrieve  information  about  a 
name  that  is  not  defined  in  the  lata 
base. 


CLDCOM 


PARAMETER  LEGAL  ONLY  IN  MTS  VERSION  - 


CLDEL 


PARAMETER  LEGAL  ONLY  IN  MTS  VERSION  - 


CLDTCT 


PARAMETER  LEGAL  ONLY  IN  MTS  VERSION  - 


CLKHIC 


PARAMETER  LEGAL  ONLY  IN  MTS  VERSION  - 


CLP  A V 


PARAMETER  LEGAL  ONLY  IN  MTS  VERSION  - 


CLPTOM 


PARAMETER  LEGAL  ONLY  IN  MTS  VERSION 


CLPTC 


PARAMETER  LEGAL  ONLY  IN  MTS  VERSION  - 


CLPCOM 


PARAMETER  LFGAL  ONLY  IN  MTS  VERSION  - 


CLREN 


PARAMETER  LEGAL  ONLY  IN  MTS  VERSION  - 


CLSTF 


PARAMETER  LFGAL  ONLY  IN  MTS  VERSION  - 


CLDEL 


NO  NAME  OR  FILE  HAS  SPECIFIED 
Either  the  NAME  or  FILE  parameter  aust  ba 
given  for  this  coaaand  to  be  executed. 
Parameters  given  do  not  supply  sufficient 
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89  MAIN  PRTO 


R9  PROBE 

40  PWLTST 


41  ADDUSE 


42  MAIN  PAY 


93  MAI  N PA  V 


44  INPAR 

45  CLEI 


95  MAIN  SAVE 

97  MAINSAVF 

98  CONCOL 

99  TDEMTR 

IOC  NLTST2 


inforaation  for  processing.  Reissue 
coaaand , 

NAME  NOT  A PROCESS  NAME 
Atteapt  to  retrieve  inforaation  froa  a 
naae  that  is  not  a PROCESS  naae.  Only 
PROCESS  naaes  aay  be  used  as  input  to 
this  coaaand. 

LOOP  IN  SflR  PART/UTIL  I Z ES  STRUCTURE  AT  - 

SSCN  IS  ONLY  LEGAL  TYPE  IN  DEFINE  SECTIO* 

WHICH  CAN  BE  MAINTAINED 

Atteapt  to  use  MAINTAINED  stateaant  for 

soae  object  which  is  not 

SUBSETTI NG-CRITBR ION. 

^00  MANY  USAGES 

OP A software  error.  Please  notify 
persons  aaintaininq  UFA  should  this  error 
occur . 

NAME  NOT  IN  DATA  BASF. 

Atteapt  to  retrieve  inforaation  about 
naae  which  is  not  defined  in  the  data 
ba  se. 

NAME  HAS  NO  USAGES  AS  ATTRIBUTE  FOR 
AN  YTH  TMG 

Atteapt  to  retrieve  ATTRIBUTE  inforaation 
for  a naae  which  is  not  an  ATTRIBUTE. 

COMMANDS  IN  IMCOFRFCT  SEQUENCE 

MU  S'1'  GIVE  EITHER  ENTITY  OR  IDENTIFIER 
PARAMETER 

Either  the  ENTITY  or  IDENTIFIER  parameter 
aust  be  used  in  conjunction  with  this 
coaaand  for  successful  iapleaenti tion . 

WRITE  ERROR  - DATA  BASE  NOT  SAVEO 

DATA  BASE  NOT  SAVED  - FILE  CANNOT  BE 
EMPTIED  - 

NAME'  NOT  IN  DATA  BASE 

Atteapt  to  retrieve  inforaation  about  a 
naae  not  defined  in  the  data  base. 

NAHF  NOT  TN  DATA  BASE 

Atteapt  to  retrieve  inforaation  about  a 
naae  not  defined  in  the  data  base. 

TOO  MANY  ATTRIBUTE  VALUE  PAIRS  IN  SINGLE 


Part  I User  Requirements  Analyze 


H61 80 /Mu  1 1 i cs /UR  A User's  Manual 


47 


t 


! 


I 


STATFMEN  T 

Limit  exceeded.  Remaininq  pairs  should 
be  qiven  in  another  statement. 

101 

NLIST2 

NAME  ALRFADY  USED  IN  DIFFERENT  CONTEXT 
Atteipt  to  use  a name  defined  as 
somethinq  else  as  an  ATTRIBUTE  name. 

102 

NLTST2 

NAME  ALREADY  USED  IN  DIFFERENT  CONTEXT 
Atteipt  to  use  a name  defined  as 
somethinq  else  as  an  ATTR I BUT E- VA LU E 
name. 

’03 

DFLSFT 

DESCRIPTION  COMMENT  ENTRY  NOT  FOUND  FOR: 
Attempt  to  delete  a nonexistent 
DESCRIPTION  statement. 

1 34 

DFLSFT 

PROCEDURE  COMMENT  ENTRY  NOT  FOUND  FOR: 
Attempt  to  delete  a nonexistent  PROCEDURE 
st  at  em  en  t . 

ITS 

PFL5E" 

VOLATILITY  COMMENT  NOT  FOUND  FOR: 

Atteipt  to  delete  a nonexistent 

VOLATILITY  statement. 

108 

p^ls^t 

VOLANT LI^Y- MEMBER  COMMENT  ENTRY  NOT  FOUND 
FOR: 

Attemp*  to  delete  a nonexistent 

VOLATT  LI "Y-mFMBFR  statement. 

107 

DFLSFT 

VOLATLITY-SET  COMMENT  ENTRY  NOT  FOUND 
FOR; 

Attempt  *o  delete  a nonexistent 
VOLATILITY-SET  Statement. 

10  8 

DFLSFT 

DFRIVATION  COMMENT  ENTRY  NOT  FOUND  FOR: 
Attempt  to  delete  a nonexistent 

DFRIVATION  statement. 

103 

PELS  FT 

TP  UF  WHILE  COMMENT  ENTRY  NOT  FOUND  FOR: 
Attempt  to  delete  a nonexistent  TRUE 

WHILE  statement. 

’10 

DELS  TT 

FALSE  WHILF  COMMENT  NOT  FOUND  FOR: 

Attempt  to  delete  a nonexistent  FALSE 
WHILE  statement. 

1 1 1 

MAIN  DCOM 

NAMF  NOT  FOUND  IN  DATA  BASE 

Atteipt  to  delete  information  for  a name 
not  defined  in  the  data  base. 

112 

PUNSET 

NC  DESCRIPTION  AVAILABLE  FOR  : 

113 

CLCM 

MUST  O I V F FTTHFP  CONSISTS  OR  CONTAINED 
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114  VLIST 


ns  VLIST 


Ilf  OTRFPS 


117  PTHEPS 


118  CLRCA 


114  CLPCA 


1 20  SNAMET 


121  MAIN  PCr>v! 


122  MAIN  PCOM 


PARAMETER 

Either  the  CONSISTS  or  CONTAINED 
parameter  must  h°  used  in  conjunction 
with  this  coaiand, 

ONLY  SINGLE  VALUE  OR  RANGE  ALLOWED  - 
IGNORED 

Invalid  format  for  specifying  a VALUES 
statement.  See  the  "User  Requirements 
Language,  Version  3.2,  Language  Reference 
Manual . " 1 

MIN  NOT  LESS  THAN  MAX  - IGNORED 
If  a number  range  is  specified  the  first 
number  must  be  less  than  the  second 
number . 

VALUES  ONLY  LEGAL  POR  ELEMENT , SYSPAR,  OC 
ATTPI  BUTE-VALUE 

Attempt  to  use  a VALUES  statement  for  a 
name  which  is  not  an  ELEMENT, 
SYSTEM-PARAMETEF  or  ATTRI BUT E- V ALU E . 

DIFFEPENT  VALUES  ALREADY  GIVEN 
Attempt,  to  assign  a second  value  for  a 
given  obiect.  This  statement  is  ignored. 

FI LE=  NOT  ALLOWED  IN  THIS  IMPLEMENTATION 
Error  encountered  in  using  a 
SYSTEM-PARAMETER  in  a given  statement. 
Interpretation  of  rest  of  statement 
becomes  confused. 

PtJ  NCH  ~ NOT  ALLOWED  IN  THIS  IMPLEMENTATION 
Attempt  to  use  zero  as  a 
SYSTEM-PARAMETER. 

NAMF  ALPFADY  USED  IN  DIFFERENT  CONTEXT 
Attempt  to  use  a name  in  a context,  which 
conflicts  in  the  way  it  has  previously 
been  used. 

NAME  NOT  FOUND  IN  DATA  BASE 

Attempt  to  access  information  for  a name 

not  defined  in  the  data  base. 

INVALID  TYPE  OF  COMMENT  ENTRY 
Attempt  to  replace  unrecognizable  comment 
entry  statement.  Probably  a spelling 
error . 
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123 


124 


128 


12ft 


127 


128 


129 


130 


131 


1 32 


i » l 


• •« 


MAIN  PCOM 


PEP? FT 


MAIN  ROOM 


PEPS  ET 


PUN  SET 


PUNSET 


PUNS  ET 


PUNSET 


PUNSFT 


PUNSET 


PUNSET 


PUNSET 


CANNOT  HAVF  THIS  TYPE  OF  COMMENT  ENTRY 
Attempt  to  assign  a comment  entry 
statement  which  is  not  legal  for  the 
oarticular  name  type. 

...WITH  THIS  NAME 

Used  in  con-junction  with  URA123. 

Specifies  the  name  for  which  the  comment 
entry  was  used. 

PROBLEMS  SCANNING  INPUT  FILE  - MOST  ABORT 
Incorrect  format  of  file  used  for  input. 
See  command  description  for  correct 
f ormi  t . 

WAPNING  - THERE  IS  NO  COMMENT  ENTRY  TO 
DELETE 

Attempt  to  delete  nonexistent  comment 
entry  . 

DESCRIPTION  COMMENT  ENTRY  NOT  FOUND  FOP: 
Attempt  to  retrieve  nonexistent 
DESCRIPTION  statement. 

P°OCF  DU  R F COMMENT  ENTRY  NOT  FOUND  POR: 
Attempt  to  retrieve  nonexistent  PROCEDURE 
st  atement . 

VOLATILITY  COMMENT  NOT  FOUND  FOR: 

Attempt  to  retrieve  nonexistent 
VOLATILITY  statement. 

VOLATILITT-MEMBER  COMMENT  ENTRY  NOT  FOUND 
FOR : 

Attempt  to  retrieve  nonexistent 
VOLATILITY-MEMBER  statement. 

VOLATILITY-SET  COMMENT  ENTRY  NOT  FOUND 
FOP: 

Attempt  to  retrieve  nonexistent 
VOLATII.TTY-SFT  statement. 

DERIVATION  COMMENT  ENTRY  NOT  FOUND  POR: 
Attempt  to  retrieve  nonexistent 
DERIVATION  statement. 

TRUE  WHILE  COMMENT  ENTRY  NOT  FOnN D FOR: 
Attempt  to  retrieve  nonexistent  TRUE 
WHILE  statement. 

FALSF  WHILE  COMMENT  NOT  FOUND  FOR: 

Attempt  to  retrieve  nonexistent  FALSE 
WHILE  statement. 
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135 

MAIN  PCOM 

NAME  NOT  FOUND  IN  DATA  BASE 

Attempt  to  retrieve  information  for  a 
name  not  defined  in  the  data  base. 

1 35 

PELMT 

NO  ELEMENTS  SATISFY  THE  REQUESTED 
ATTRIBUTE-VALUES 

1 37 

MAINVAL 

NAME  NOT  IN  DATA  BASE  - 

1 38 

MAIN VAL 

NAME  IS  NOT  AN  ATTRIBUTE  OR  IT  HAS  NO 
VALIIF  - 

139 

MAINVAL 

NO  NAMES  IN  DATA  BASE 

140 

MANDP 

VALUE  OF  MM  IS  GREATER  THAN  THE  NUMBER  OF 
MAND. ATTP.  - IGNORED 

141 

CONROW 

NAME  NOT  IN  DATA  BASE 

Attempt  to  retrieve  i nfoL nation  for  a 
name  not  defined  in  the  data  base. 

142 

CLPC  A 

EMPTY  NOT  ALLOWED  IN  THIS  IMPLEMENTATION 
Attempt  to  delete  a relationship,  between 
two  names,  which  is  not  defined  in  the 
data  bise. 

143 

MAIN  OP 

NAME  NOT  IN  DATA  BASE 

Atteipt  to  retrieve  information  about  a 
name  which  is  not  defined  in  the  data 
base. 

1 4 4 

DPCOT. 

TOO  MANY  COLUMNS 

Exceeded  limits  of  the  software  that 
produces  the  matrix.  Names  omitted  from 
the  matrix  should  be  used  as  input  to 
another  DP  command. 

145 

DPCOL 

TOO  MANY  ROWS 

Exceeded  limits  of  the  software  that 
produces  the  matrix.  Names  omitted  from 
the  matrix  should  be  used  as  input  to 
another  DP  command. 

145 

dpcol 

SPARSE  MATRIX  SYSTEM  OVERFLOW 

Exceeded  limits  of  the  software  that 
produces  the  matrix. 

147 

DPROW 

TOO  MANY  ROWS 

Exceeded  limits  of  the  software  that 
produces  the  matrix.  Names  omitted  from 
the  matrix  should  be  used  as  input  to 
another  DP  command. 

149 

OPR  0 W 

TOO  MANY  COLUMNS 
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Exceeded  limits  ot  the  software  that 
produces  the  natrix.  Names  omitted  from 
the  natrix  should  he  used  as  input  to 
another  DP  command, 

1 U €>  DPPOW  SPARSE  MATRIX  SYSTEM  OV  ER  PLOW 

Exceeded  Units  of  the  software  that 
produces  the  natrix. 

150  PPSriM  MO  ROMS 

Mo  relationships  can  be  specif iei  about 
the  names  used  as  input,  so  no  matrix 
will  he  qenerated. 

151  DPSHM  NO  COLUMNS 

Mo  relationships  can  he  specifiel  about 
the  names  used  as  input,  so  no  matrix 
will  he  generated. 

15  2 poSUM  SPARSE  MATRIX  SYSTEM  OVERFLOW 

Exceeded  limits  of  the  software  that 
produces  the  matrix. 

151  M AT N DP  INVALID  INPUT  NAME  TYPE 

Attempt  to  use  a name  which  is  not  a 
PROCESS  name  as  input  to  the  comiand. 

1 5 U MAIMDP  INVALID  INPUT  NAME  TYPE 

Attempt  to  use  a name  which  is  not  a SET, 
INPUT,  OUTPUT,  ENTITY,  CROUP  or  ELEMENT 
name  as  input  to  the  command. 

155  DPSUM  INVALID  ROM  TYPE  - SYSTEM  ERROR 

UPA  software  error.  Please  notify 
persons  maintaining  URA  should  this  error 
occur . 

155  CLRCA  NO  INTERVAL  GIVEN  - MUST  ABORT 

Attempt  to  delete  a relationship  which 
has  not  been  defined  in  the  data  base. 

157  CLRCA  NBP  AND  NHP  NOT  ALLOWED  TOGETHER  - MUST 

ABORT 

Attempt  to  delete  a relationship  which 
has  not  been  defined  in  the  data  base. 

1 SB  PBTON  NAME  NOT  IN  DATA  BASE 

Atteipt  to  delete  a relationship  which 
has  not  been  defined  in  the  data  base. 

15R  DBTCON  NAMES  NOT  CONNECTED  IN  THAT  FASHION 

Attempt  to  delete  a relationship  which 
has  not  been  defined  in  the  data  base. 
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160  UDDEPS 


161  UDDERS 


1*2  UDDERS 


161  PPTPR 


1 6 U PRTRS 


165  UPDTPR 


166  UDDEPS 


167  UDDERS 


Iff!  UDDERS 


169  ADJINT 


170  ADvIT  NT 


171  DELS YN 


NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which 
has  not  been  defined  in  the  data  base. 

NO  CONNECTIVITY  EXISTS 

Attempt  to  delete  a relationship  which 

does  not  exist  for  this  name. 

DIFFERENT  CONNECTIVITY  IN  DATA  BASF  - NOT 
DELETED 

Attempt  to  delete  a relationship  which  is 
not  stated  exactly  as  it  is  in  the  data 
base. 

NO  PROCESSOR  INFORMATION  FOUND  IN  DATA 
BASE 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 


NO  PROCESSOR  INFORMATION  FOUND  IN  DA^A 
BASE 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

SYSTEM  PARAMETER  WITHOUT  VALUE  - 
Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 


NAME  NOT  IN  DATA  3ASE 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 


DIFFERENT  VALUES  IN  DATA  BASE-  NOT 
DELETED 

Attempt  to  delete  a number  or  range  of 
numbers  that  was  not  defined  for  the 
statement . 

HAPPENS  INFORMATION  NOT  CONVERTIBLE  FOR 
THE  INTVL  - 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

SYSTEM  PARAMETER  WITHOUT  VALUE 
ENCOUNTERED  - 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

NAME  NOT  TN  DATA  BASE 

Attempt  to  delete  a relationship  which  is 
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172  DELS  Y N 


173  DPT  V F S 


174  DRIVES 


17S  DRIVES 


176  DRIVES 


777  DRIVES 


77 8 DHAPNS 


1 7 D DRIVFS 


ISO  DHAPNS 


1 P 1 DTSCON 


1 P 2 DISCON 


1 R 3 DISCON 


1R4  ATTV 


not  defined  in  the  data  base. 


NAME  IS  NOT  A SYNONYM  FOR  THIS  NAME 
Atteipt  to  delete  a SYNONYM  relationship 
which  is  not  defined  in  the  data  base. 


USES  INFORMATION  NOT  IN  DATA  BASE 
Atteipt  to  delete  a relationship  which  is 
not  specified  exactly  as  it  is  in  the 
data  base.  Relationship  is  not  deleted. 


WAPNINS  - " US  I NO”  INFO  IN  A DATA  BASE 
Statement,  deleted  although  the 
relationship  has  not  been  specified 
exactly  as  in  the  data  base  (the  "OSINS" 
clause  has  been  omitted). 

NAMF  NOT  IN  DATA  BASE 

At  tern  pt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 


THFSE  TWO  NAMES  NOT  CONNECTED  IN  THAT  WAY 
Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 


NAMF  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 


"IISTNO"  NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is 

not  defined  in  the  data  base. 


NAMES  NOT  CONNECTED  IN  THAT  FASHION 
Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 


NAMF  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

NAMES  NOT  CONNECTED  IN  THAT  FASHION 
Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

NAME  DOESN'T  HAVE  THIS  ATTRIBUTE 
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185  ATT  V 

18*  ATTV 

187  DCNSIS 

188  DCNSIS 

198  DCNSIS 

1«0  DCNSIS 

191  DCNSIS 

192  PPERCA 

193  PRERCA 

194  PR5PRO 

195  MAINSECA 

198  PLONG 


Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

NAME  NOT  IN  DATA  BASE 

Atteipt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

NAME  HAS  NO  ATTRIBUTES 

Atteipt  to  delete  ATTRIBUTE  relationship 
for  a name  with  no  ATTRIBUTES. 

SYSPAR  VALUE  IN  DATA  BASE  IS  DIFPERENT  - 
IGNORED 

Attempt  to  delete  a statement  using  a 
different.  SYSTEM-PARAMETER.  Statement 
not  deleted. 

WARNING  - SYSPAR  IN  DATA  BASE 
Statement  deleted  though  user  did  not 
include  SYSTEM-PA RAMETER  with  statement. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a CONSISTS  relationship 
using  a name  not  defined  in  the  data 
ba  se. 

CONST STS/CONTAINED  INFORMATION  NOT  IN 
DATA  BASE 

Atteipt  to  delete  a CONSISTS  or  CONTAINED 
relationship  not  defined  in  the  data 
base. 

NO  SYSPAR  IN  DATA  BASE  - IGNORED 
Attempt  to  delete  a relationship  which  is 
not  defined  exactly  in  the  same  way  as 
defined  in  the  data  base.  Statement  not 
deleted . 

NAME  GIVEN  AS  KEYWORD  IS  NOT  A KEYWORD  - 
Attempt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

NAME  GIVEN  AS  AN  INTV  L IS  NOT  A I NT  VL  - 

NAME  GIVEN  AS  PROCESS  IS  NOT  A PROCESS  - 

NAME  NOT  IN  DATA  BASE  - 

Atteipt  to  delete  a relationship  which  is 
not  defined  in  the  data  base. 

COMMENT  NOT  POUND  ***SYSTEM  ERROR  *** 

URL  software  error.  PLease  notify 
persons  maintaining  URL  should  this  error 
occur . 


Patft  I 
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197  COUNT 


198  COM  NT 


199  DHAPNS 


2Cn  DHAPNS 


?9 1 PLIST 


29  2 NLTST 


20  7 MAIN  SEC  A 


29  4 DEFN 


295  SETSYN 


2C6  SETSYN 


2C7  SETSYN 


COMMENT-ENTRIES  NOT  ALLOWED  IN  DPSL 
Attempt  to  delete  comment-entry 
statements.  This  can  only  be  done  using 
the  DCOM  and  RCOM  coaaands.  Statement 
not  deleted. 

EOE  WHILE  LOOKING  FOP  SEMICOLON 
Improper  statement,  syntax  has  been 
encountered.  Semicolons  are  needed  to 
end  all  URL  statements. 

DIFFERENT  SYSPAR  - NOT  DELETED 
Atteapt  to  delete  a HAPPENS  relationship 
using  a different  SYSTEM-PARAMETER  than 
defined  in  the  data  base.  Statement  not 
deleted  . 

INTERVAL  NOT  IN  DATA  BASE 

Atteapt  to  delete  a HAPPENS  relationship 

using  an  INTERVAL  not  defined  in  the  data 

base. 

NAME  NOT  PART  OF  HEADER 
An  illegal  statement  header  has  been 
given.  Probably  a spelling  error.  The 
statement  is  ignored. 

NAME  PREVIOUSLY  USED  DIFFERENTLY  - 
IGNORED 

Atteapt  to  use  a name  in  a context 
different  than  the  way  it  is  defined. 
(This  error  is  also  described  in  section 
10.1.) 


INPUT  NAME  HAS  INVALID  TYPE 
Attempt  to  delete  a relationship  not 
defined  in  the  data  base. 

NAME  ALREADY  USED  IN  DIFFERENT  CONTEXT 
Attempt  to  assiqn  a name  type  to  a name 
which  is  used  in  a different  context. 

ALREADY  SYNONYM  FOR  SOMETHING  ELSE 
Atteapt  to  assign  a name  to  be  a STNONYH 
for  more  than  one  object. 

UNABLE  TO  MAKE  SYNONYM  - TOO  COMPLICATED 
See  section  10.1,  part  vii  for 
explanation  and  solution  to  this  error. 

CANNOT  BE  MADE  SYNONYM  - DIFFERENT  TYPES 
Atteapt  to  assign  a name  as  a SYNONYM  to 
a different  name,  both  with  different 
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2n  R 

2"U 

210 

211 

212 

211 

21U 

215 

216 

217 

211 


NAINNLA 

CHKCON 

PRTNUN 

OTHERS 

OTHERS 


OTHERS 


OTHERS 


RWLI S2 


OTHERS 


OTHERS 


OTHERS 


name  types. 

HO  NAMES  IN  DATA  BASE 

STACK  OVERFLOW  WHILE  WALKING  CONSISTS 
STRUCTURE 

Atteapt  to  use  a naae  which  is  not  an 
INTERVAL  in  a CONSISTS  stateaent  for  an 
INTERVAL  section. 

NO  NAMES  IN  DATA  BASE 

Atteipt.  to  use  a naae  in  a context 

different  than  the  way  the  naae  is 

defined. 

NAME  MUST  BE  ENTITY  NAME 

Atteapt.  to  use  a naae  in  a context  where 
only  an  ENTITY  naae  is  acceptable. 

RELATION  ALREADY  EXISTS  BETWEEN  TWO  OTHER 
ENTITIES 

Atteapt  to  specify  the  saae  RELATION  for 
a different  pair  of  ENTITIES.  Different 
ENTITY  pairs  imply  different  RELATIONS. 

CAN  ONLY  HAVE  ONE  CARDINALITY 
Atteapt  to  specify  a second  CARDINALITY 
statement  for  a name.  Objects  may  have 
only  one  CARDINALITY. 

CONNECTIVITY  ALREADY  GIVEN  FOR  THIS 
RFLATTON 

Atteapt  to  specify  a second  CONNECTIVITY 
statement  for  a naae.  RELATIONS  may  have 
only  one  CONNECTIVITY. 

ALREADY  CONTAINS  WITH  DIFFERENT  SYSTEM 
PARAMETER 

Attempt  to  specify  the  same  CONSISTS 
statement,  but  with  two  different 
SYSTEM-PARAMETERS. 

NAME  MUST  BE  ENTITY  NAME  BEFORE  VIA 
Atteapt  to  use  a name  in  a stateaent 
where  only  an  ENTITY  name  is  allowed. 

NAME  MUST  BE  RELATION  AFTER  VIA 
Attempt  to  use  a name  in  a stateaent 
where  only  a RELATION  naae  is  allowed. 

RELATION  ALREADY  EXISTS  BETWEEN  DIFFERENT 
ENTITY  PAIR 

Atteapt  to  specify  the  saae  RELATION  for 
a different  pair  of  ENTITIES.  Different 
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ENTITY  pairs  imply  different  RELATIONS. 

21»  CLSECA  FILE3  NOT  ALLOWED  IN  THIS  IMPLEMENTATION 

Attempt  to  use  a naae  in  a statement 
where  only  a CONDITION  naae  is  allowed. 


22?  SETSYN  CANNOT  HAKF  A NAME  FOR  TTSELF 

Atteapt  to  specify  a basic  naae  as  a 
synonym  for  itself.  Basic  names  cannot 
also  be  svnonyms. 


221 

VLIST 

TOO  MANY  NAMES  - REST  IGNORED 

Attempt  to  specify  a list  of  naiss  for  a 
statement  where  only  a single  naae  is 
accept  able. 

'* 

• 

22  5 

R WLT  ST 

CANNOT  HAVF  KEYWORD  FOR  KEYWORD 

Attempt,  to  assiqn  a KEYWORD  to  a KEYWORD 
name. 

r, 

■ 

229 

P WLT ST 

CANNOT  HAVF  SECURITY  FOR  SECURITY 

Attempt  to  assiqn  a SECURITY  statement  to 
a SECURITY  name. 

* *> 

a 

i: 

">29 

RWLIST 

CANNOT  HAVF  SOURCE  FOR  SOURCE 

Atteipt  to  assiqn  a SOURCE  to  a SOURCE 
name. 

211 

RWLI S'” 

SYNONYMS  ONLY  APPLIED  TO  FIRST  NAME 

Atteipt  to  assiqn  a SYNONYM  to  more  than 
one  name.  The  SYNONYM  is  given  only  to 
the  first  name. 

« 1 

• 

. 

• 

J 

272 

APPLES 

APPLIES  STATEMENT  ILLEGAL  WITH  THIS  NAME 

T Y DF 

Attempt  to  use  APPLIES  stateient  for  a 
name  which  is  not  a KEYWORD,  MAILBOX, 

SFCURTT  or  SOURCE. 

• 

\ 

211 

DEFN 

TOO  MANY  NAMES  IN  DEFINE  HEADER  - REST 

IGNORED 

Exceeded  5C  name  limit,  remaining  names 
should  be  qiven  in  another  statement. 

s 

234 

OPTRW 

! ' 1 

NAME  ALRFADY  USED  IN  DIFFERENT  CONTEXT 

Attemot  to  use  a naae  in  a wrong  context. 

Only  a PROCESS  naae  can  be  used  in  this  1 

context . 

■ 

235 

OPT  0 N 

NAME  ALREADY  USED  IN  DIFFERENT  CONTEXT 

Attempt  to  use  a name  in  wrong  context 
for  an  UPDATES  relationship. 

« 

275 

OPTION 

NAHF  LIST  TOO  LONG  - REST  IGNORED 
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240  APPLES 

241  APPLES 

242  QROPEN 

241  Q WOP  EH 

244  INPAPA 

245  GETS  EC 

246  APPLES 

24f  APPLES 

248  APPLES 


KEYWORD  CANNOT  APPLY  TO  KEYWORD 
Attempt  to  use  the  APPLIES  statement  in 
the  wrong  context. 

MATLBOX  CAN  ONLY  APPLY  TO  PD 

Attempt,  to  use  the  APPLIES  stateaent  in 

the  wrong  context. 

ATTEMPT  TO  OPEN  TOO  MANY  Q FILES  - SYSTEM 
ERROR 

ATTEMPT  TO  OPEN  TOO  MANY  3 FILES  - SYSTEM 
p R POR 

COMMANDS  IN  INCORRECT  SEQUENCE 
***  SYSTEM  ERROR 

SECURITY  CANNOT  APPLY  TO  SECURITY 
Atteapt  to  use  the  APPLIES  stateaent  in 
the  wronq  context. 

SOURCE  CANNOT  APPLY  TO  SOURCE 

Atteapt  to  use  the  APPLIES  stateaent  in 

the  wronq  context. 

MEMO  CANNOT  APPLY  TO  MEMO 

Atteapt  to  use  the  APPLIES  stateaent  in 

the  wrong  context. 


249  APPLES  INVALID  SECTION  - WODPS 

UFA  software  error.  Please  notify 
persons  maintaining  URA  should  this  error 
occur . 

250  LIOERE  ***  SYSTEM  ERROR 


251  SNAMET 


252  SETSYN 


253  RWLIST 


254  NANCE 


ATTEMPT  TO  CHANGE  TYPE  WHEN  ALREADY  TYPED 
URA  software  error.  Please  notify 
persons  maintaining  URA  should  this  error 
occur . 

SYNONYM  TABLE  OVERFLOW 
Exceeded  UFA  limits.  The  user  should 
reissue  INPUT-PSL  command  at  point  in  the 
input  file  where  this  error  occurred. 

INVALID  STATEMENT  NUMBER 
UFA  software  error.  Please  notify 
persons  maintaining  URA  should  this  error 
occur , 

**♦  SYSTEM  ERROR  ***  CANNOT  CREATE 
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SYNONYM 

UFA  software  error.  Please  notify 
persons  maintaining  URA  should  this  error 
occur . 

255 

SYNTH 

NUMBER  NOT  ALLOWED  AS  SY5PAR  THIS  VERSION 
OP  UFA 

25* 

RWLIST 

CONNECTION  ALREADY  EXISTS  WITH  DIFFERENT 
VALUE  OF  NAME 

UFA  software  error.  Please  notify 
persons  maintaining  URA  should  this  error 
occur . 

257 

FOR MS L 

NAME  NOT  IN  DATA  BASE  - 

26^ 

SORTMD 

***  SYSTEM  ERROR 

265 

RHLI ST 

CONNECTION  ALREADY  EXISTS  WITH  DIFFERENT 
VALUE  OF  NAME 

Attempt  to  specify  same  relationship 
between  two  INTERVAL  names  though  with 
different  SYSTEM-PARAMETER.  Not  allowed. 

266 

TLLST 

\ 

ILLFGAL  STATEMENT  IN  THIS  SECTION 

Attempt  to  use  a 0 PL  statement  in  a wrong 
context.  See  "User  Requirements 

Language,  Version  4.0,  Language  Reference 
Manual".  » 

267 

TLLST 

NO  CURRENT  SECTION 

Atteipt  to  use  an  illegal  section  header 
statement.  See  "User  Requirements 
Lanquage,  Version  4.0,  Language  Reference 
Manua 1"  . » 

269 

NLTST 

NAME  LIST  TOO  LONG,  REST  IGNORED 

Limit  of  50  names  has  been  exceeded. 
Remaining  names  should  be  given  in 
another  statement. 

77C 

TNPAP 

ERPOR  OPENING  DATA  BASE  - MUST  A90RT 
Attempt  to  use  an  inconsistent  data  base. 
No  processing  can  he  done  on  it.  (See 
section  10 . 1 . ) 

271 

MAINCNC 

NAME  NOT  IN  DATA  BASE 

Attempt  to  retrieve  information  for  a 
name  not  defined  in  the  data  base. 

277 

CNCBLO 

TOO  MANY  RONS  - STOPPING  HERE 

> Part  II  of  the  URL  User's  manual. 
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271  CNCBLD 


274  CNCBLD 


27«i  CNCBLD 


276  CNCBLD 


277  CNCBLD 


?TR  CNCBLD 


274  CNCSUM 


2 BO  CNCSUM 


211  CNCSUM 


212  MUST 


Exceeded  Units  of  software  that  produces 
the  aatrix.  Naies  omitted  fron  the 
aatrix  should  be  used  as  input  to  another 
CSC  command. 

NAMF  DOESN'T  CONSIST  OP  ANYTHING 
No  information  can  be  presented  for  this 
name  in  the  aatrix. 

TOO  MANY  LEVELS  - LOWER  LEVEL  STUPP 
IGNORED 

Too  many  levels  of  CONSISTS  inforaation 
to  he  presented. 

***THE  POLLOWING  NAMES  ARE  INVOLVED  IN  A 
LOOP: 

This  problea  should  be  corrected  by 
modifying  the  CONSISTS  statements  for 
these  names, 

TOO  MANY  LEVELS  - LOWES  LEVEL  STJ PP 
IGNORED 

Too  many  levels  of  CONSISTS  information 
to  be  presented. 

TOO  MANY  COLUMNS  - STOPPING  HERE 
• • • ♦ Ex-cT'Vflfc'd*  limits  of  software  that  produces 
the  matrix.  Names  omitted  froa  the 
aatrix  should  be  used  as  input  to  another 
CONSI ST S- COMP ARISON  coaaand. 

SPARSE  MATRIX  OVERFLOW  - STOPPING  REPP 
Exceeded  limits  of  software  that  produces 
the  matrix. 

***SD  COLUMNS,  OR  NO  ROWS  - STOPPING 
No  relationships  car.  be  specifiel  about 
the  names  used  as  input,  so  no  matrix 
will  be  generated. 

LESS  THAN  2 ROWS,  NO  SIMILARITY  MATRIX 
Not  enough  information  is  available  to 
generate  a aatrix. 

SPARSE  MATRIX  OVERFLOW  - STOPPING 
Exceeded  limits  of  software  that,  produces 
the  matrix. 

STACK  OVERFLOW  - CONTINUING 
Exceeded  Units  of  software  that  produces 
the  report.  An  attempt  is  made  to 
recover  and  process  as  much  data  as 
possible. 
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2*n  HAVE  STACK  OVERFLOW  - CONTINUING 

Exceeded  limits  ot  software  that  produces 
the  report..  An  attempt  is  made  to 
recover  and  process  as  much  data  as 
possi  hie. 

2HU  HAINSTR  TOO  1 AN Y LEVELS  - CONTINUING 

Exceaded  limits  of  software  that  produces 
the  report.  An  attempt  is  made  to 
process  as  much  data  as  possible. 

F&PPS  THE  FOLLOWING  NAMES  ARE  INVOLVED  IN  LOOPS 


Throaqh  incorrect  specification  of 
PARTS /SURPARTS  statements,  loops  have 
heen  implied  in  structures  of  objects  in 
the  problem  statement.  The  user  should 
determine  which  PAFTS/SUBP ARTS 
relationships  should  be  changed  and 
delete  them  via  the  DELETE- PSL  command. 

’’•RINTV  NO  FREOUENCY  INFORMATION  IN  DATA  BASE 

No  HAPPENS  statements  have  been  specifies 
in  the  prohlem  statement  stored  in  the 
data  base.  If  any  output  is  desired  from 
this  report,  at  least  one  HAPPENS 
statement  must  be  in  the  data  base. 

NO  NAMES  IN  INDEX 

Attempt,  to  generate  an  index  into  a 
report  presenting  no  information  about 
any  names.  This  is  merely  a warninq. 

VO  NAMES  AT  LEVEL  ONE 

Attempt  to  qenerate  STRUCTURE  report  for 
names  of  particular  name  type  (i. e. , 
PROCESS,  INPUT,  OUTPUT  or  INTERFACE),  but 
no  names  of  this  type  currently  exist  in 
the  data  base.  To  qenerate  this  report 
for  PROCESS  names,  for  example,  at  least 
one  PROCESS  must  be  defined  in  the  data 
base. 

PCLR  BT  NO  PICTURE  AVAILABLE  FOP 

Attempt  to  qenerate  a PICTURE  for  names 
which  legally  have  a PICTURE,  but  no 
information  that  was  specified  for  this 
name  can  be  presented  in  PICTORB  format. 
Information  that  may  be  presented  in  a 
PICTURE  is  any  dealing  with  interaction 
of  data  and  PROCESSES  and  structure 
(CONSISTS  and  SUBPARTS  statements). 
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na ne  type  as  a SYNONYM  to  another  naie 
which  has  been  used  in  some  context  in 
conflict  with  the  manner  in  which  the 
UNDEFINED  name  has  been  used. 


281 

INPDUH 

ERROR  OPENING  DATA  BASE  FOR  - 

282 

INPDUM 

DATA  BASE  IS  EMPTY 

293 

MAIN  PRES 

INVALID  INPUT  CODE 

?8(| 

INPRES 

EFPOR  OPENING  DATA  BASE  FOR  - 

29S 

INPRES 

DATA  BASF  FUST  BE  EMPTY 

ABPRES 

******  RUN  ABORTED  ****** 

297 

INPRES 

NULL  OR  INVALID  FIRST  CARD 

298 

GE^DMC 

SEQUENCE  ID  OUT  OR  ORDER 

288 

GETDNP 

SEQUENCE  ID  OUT  0?  ORDER 

3?P 

pnrRNo 

INVALID  RANGE  S*>FC 

901 

TP^NTR 

** *TDO  MANY  COLUMNS  --  MUST  STOP  HERE*** 
Exceeded  limits  of  software  that  produces 
the  matrix.  Names  emitted  from  the 
matrix  should  be  used  as  input  to  another 
ENTITY-TDFNTIFIER  command. 

902 

IDENT° 

***T00  MANY  ROMS  --  MUST  STOP  HERE*** 
Exceeded  limits  of  software  that  produces 
the  matrix.  Names  omitted  from  the 
matrix  should  be  used  as  input  to  another 
ENTITY-IDENTIFIER  command. 

303 

TDENTR 

***MA  TRI X OVERFLOW  — .MUST  STOP  HFRE*** 
Exceeded  limits  of  software  that  produces 
the  matrix. 

3^4 

TDFNTR 

THE  FOLLOWING  NAMES  DO  NOT  IDENTIFY 
ANYTHING: 

No  information  can  be  presented  in  the 
matrix  for  these  names  because  they  do 
not  "IDENTIFY"  any  ENTITIES. 

90S 

IDENTC 

***TDO  MANY  COLUMNS  --  MUST  STOP  HERE*** 
Exceeded  limits  of  software  that  produces 
the  matrix.  Names  omitted  from  the 
matrix  should  be  used  as  input  to  another 
ENTITY-IDENTIFIER  command. 

306 

IDENTC 

***T00  MANY  POVS  — MUST  STOP  HERE*** 

■ 


f 

i 


Part  T User  r<  e y.i  irr  ment  s Anlyier 


■ 

AD-A057  130  MICHI6AN  UNIV  / 

USER  REGUIREMENl 
MAR  77  D TEICHf 

UNCLASSIFIED 

kNN  ARBOR  DEPT  OF  INOOSTRIAI 
rS  ANALYZER  (URA)  USER’S  MAI 
IOEW.  A HERSHEY,  S SPEWAK 

ESD-TR-7B- 

L AND  OPERA— ETC  F/6  9/2 

MUAL  H6100/MULTICS/VE— ETC(U) 

F19628-76-C-0197  1 

-128  NL 

2 

AD 

A057I30 

■ 

gjp- 

1 1 

i 

> 1 

B-  frr 

L 

— 

P- 

M 

1 ^ 

SB 

' ■ 

H6180/Hul tics/UPA  User's  Manual 


63 


307  TDENTC 


308  TDENTC 


730  CONPOW 


710  CONPOW 


711  CONROR 


312  CONPOW 


310  CONCOL 


314  CONCOL 


318  CONCOL 


Exceeded  limits  of  software  that  produces 
the  aatrix.  Names  omitted  fro*  the 
matrix  should  be  used  as  input  to  another 
ENTITY-IDENTIFIER  command. 

♦♦♦MATRIX  OVERFLOW  — MUST  STOP  H B R E*  ♦ * 
Exceeded  limits  of  software  that  produces 
the  matrix. 

*HE  FOLLOWING  NAMES  ARE  NOT  IDENr  IFIED  BT 
ANYTHING: 

No  information  can  be  presented  in  the 
matrix  for  these  names  because  no 
"IDENTIFIED"  relationships  hare  been 
specified  for  them. 

***T30  MANY  COLUMNS  --  MUST  STOP  HERE*** 
Exceeded  limits  of  software  that  produces 
the  matrix.  Names  omitted  from  the 
matrix  should  be  used  as  input  to  another 
CONSISTS-MATRIX  command. 

♦♦♦TOO  MANY  ROWS  — MUST  STOP  HERE*** 
Exceeded  limits  of  software  that  produces 
the  matrix.  Names  omitted  from  the 
matrix  should  be  used  as  input  to  another 
CONSISTS-MATRIX  command. 

THE  FOLLOWING  APE  NOT  CONTAINED  IN 
ANYTHING: 

No  information  can  be  presented  in  the 
matrix  for  these  names  because  no 
"CONTAINED  IN"  relationships  have  been 
specified  for  them. 

♦♦♦MATRIX  OVERFLOW  — MUST  STOP  HERE*** 
Exceeded  limits  of  software  that  produces 
this  matrix. 

♦♦♦TOO  MANY  COLUMNS  — MUST  STOP  HERE*** 
Exceeded  limits  of  software  that  produces 
the  matrix.  Names  omitted  from  the 
matrix  should  be  used  as  input  to  another 
CONSISTS-MATRIX  command. 

♦♦♦TOO  MANY  ROWS  — MUST  STOP  HERE*** 
Exceeded  limits  of  software  that  produces 
the  matrix.  Names  omitted  from  the 
matrix  should  be  used  as  input  to  another 
CONSISTS-MATRIX  command. 

THE  FOLLOWING  DO  NOT  CONSIST  OF  ANYTHING: 
No  CONSISTS  statements  have  been  used  in 
conjunction  with  the  names  listed. 
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116 

C0N20L 

•••MATRIX  OVERFLOW  --  MUST  STOP  H 
Exceeded  Halts  of  software  that 
this  matrix. 

ERE*** 

produces 

117 

CHER  PL 

N AMP  ALPFADY  USED  IN  DIFFERENT  CO 
Attexpt  to  use  a naae  in  a contex 
different  froa  its  initial  rant  ex 

NT  EXT 
t 

t. 

lift 

PC00  5 

INVALID  T 

CODE  - SYS? 

EM  ERROR 

310 

RC0D6 

INVALID  T 

CODE  - SYSTEM  EP 

ROR 

127 

ROODS 

INVALID  T 

code  - SYSTEM  ER 

ROB 

121 

PCDP6 

INVALID  T 

CODE  - SYSTEM  ER 

ROR 

122 

PC0D6 

INVALID  T 

CODF  - SYSTEM  ER 

ROR 

123 

RCODf 

INVALID  T 

CODE  - SYSTEM  ER 

ROR 

124 

rco  P6 

MISSING  CO 

PF  10  CARD 

- SYS 

TEN  ERR 

OR 

32* 

CI.CM 

FTLE*  NOT 

ALLOWED  IN 

THIS 

IMPLEME 

NT ATION 

326 

CL2NC 

FJLF*  NOT 

ALLOWED  IN 

THIS 

IHPLEME 

NT ATION 

327 

CL73NT 

FT  LF.=  NOT 

ALLOWED  IN 

THIS 

IMPLEME 

NTATION 

12« 

C LOT 

FILE*  NOT 

ALLOWED  IN 

THIS 

IMPLEME 

NT  AT  ION 

320 

CLDCOM 

FI  LE=  NO'” 

ALLOWFP  IN 

THIS 

IMPLEME 

NTATION 

HC 

CTDFL 

FT  LF*  NOT 

ALLOWFD  IN 

THIS 

IMPLEME 

NTATION 

m 

clotc'* 

FILE*  NOT 

ALLOWED  IN 

THIS 

IMPLEME 

NTATION 

H2 

CLOP 

PILE*  NOT 

ALLOWED  IN 

THIS 

IMPLEME 

NTATION 

HI 

CL^P 

MUST  GIVE 

DATA  OR  PROCESS 

PAR AMET 

ER 

114 

cldpsl 

INPUT*  NOT 

1 ALLOWED  IN 

THIS 

TMPLEN 

ENTATION 

316 

CLET 

PILE-  PARAMETER  NOT  ALLOWE 
IMPl  EMENTATION 

D I N TH 

IS 

116 

CL*P  S 

PILE*  NOT 

ALLOWED  IN 

THIS 

IMPLEME 

NTATION 

117 

CLIP 

INPUT*  NOT  ALLOWED  IN 

Till  S 

IMPL  EH 

ENTATION 

llfl 

CLKWTC 

PTLE-  NOT 

ALLOWED  IN 

THIS 

IMPLEME 

NTATION 

110 

CLNG 

EMPTY  NOT 

ALLOWED  IN 

THIS 

IMPLEMENTATION 
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140 
14  1 
142 
'41 

144 

145 
'46 
147 

mq 

'4  8 
isq 
.151 
152 
151 

154 

155 

156 

157 

'55 

154 

154 

184 

181 


CLPCOM 

CLP  A V 

CLPCOfl 

CLPIC 

CLPPTO 

CLRCOM 

CLREN 

CLPPS 

CLP  PS 

CLNG 

CLPR 10 

CLPRTO 

RCOD  1 

PCOD  1 

PC0U4 

BOD5 

PC0D6 

CLPR  TO 

FORHSL 
OPTS  I,  V 
STNDUP 

clp: 

CLPC 


EMPTY  NOT  ALLOWED  IN  THIS  IMPLEMENTATION 

PILE*  NOT  ALLOWED  IN  THIS  IMPLEMENTATION 

PUNCH*  NOT  ALLOWED  IN  THIS  IMPLEMENTATION 

PILE*  NOT  ALLOWED  IN  THIS  IMPLEMENTATION 

PILE*  NOT  ALLOWED  IN  THIS  IMPLEMENTATION 

INPUT*  NOT  ALLOWED  IN  THIS  IMPLEMENTATION 

INPUT*  NOT  ALLOWED  IN  THIS  I H PL EM ENTATI01 

PUNCH*  NOT  ALLOWED  IN  THIS  IMPLEMENTATION 

EMPTY  MOT  ALLOWED  IN  THIS  I HP ELEN EN TATI ON 

PUNCH*  NOT  ALLOWED  IN  THIS  IMPLEMENTATION 

PUNCH*  NOT  ALLOWED  IN  THIS  IMPLEMENTATION 

EMPTY  NOT  ALLOWED  IN  THIS  IMPLEMENTATION 

PAN  OUT  OP  POOH  IN  DATA  BASE  - MUST  ABORT 

PAN  OUT  OF  ROOM  IN  DATA  BASE  - HOST  ABORT 

PAN  OUT  OF  ROOM  IN  DATA  BASE  - HOST  ABOPT 

PAN  OB’"  OP  ROOM  IN  DATA  BASE  - MUST  ABORT 

PAN  OUT  OF  ROOM  IN  DATA  BASE  - MOST  ABORT 

PUNCH  AND  FMPTY  PARAMETERS  NOT 
IMPLEMENTED  - IGNORED 

ILLEGAL  NAME  TYPE  POR  FPS 

NO  NAMES  IN  DATA  BASE 

STACK  OVERFLOW  - SYSTEM  LIMITATION 

HORIZONTAL  BOXES  TOO  LARGE  FOR  NUMBER  OP 
COLUMNS  ON  PAGE 

The  number  of  horizontal  boxes  specified 
will  not  fit  in  the  number  of  columns 
sped  f ied. 

VERTICAL  BOXES  TOO  LARGE  FOP  NUMBER  OF 
POWS  ON  PAGE 

The  number  of  vertical  boxes  specified 
will  not  fit  in  the  number  of  rows  per 
paq<*  specified. 
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191 

FILM  AT 

NAME  NOT  IN  DATA  BASE  - 

192 

»TLHAT 

NAME  NOT  EVENT  OR  PROCESS 

1Q1 

FILM  A T 

SPARSE  MATRIX  TABLE  OVERFLOW,  PHTORE  NOr 
COMPLETE 

The  process  chain  has  gotten  too  large 
for  the  software  to  handle.  This  is  a 
system  limitation,  and  to  resolve  this, 
the  number  of  links  must  be  decreased. 

?<>4 

RELl 

STACK  OVERFLOW,  PICTURE  NOT  COMPLETE 

The  number  of  successors  for  the  given 
input  name  is  too  great.  This  is  a 
software  limitation. 

19S 

*ILMAT 

LINK  LIMIT  SPECIFIED  WAS  REACHED 

This  is  not  so  much  an  error,  as  a note. 
To  obtain  a more  complete  process  chain 
picture,  the  maximum  number  of  links  must 
he  increased. 

19fi 

CLFP 

HORIZONTAL  POXES  TOO  LAR3E  FOR  NUMBER  OF 
COLUMNS  ON  PAGE 

The  number  of  horizontal  boxes  specified 
conflicts  with  the  number  of  columns 
speci  fied. 

397 

CLFP 

VEPTICAL  BOXES  TOO  LARGE  FOR  NUMBER  OF 
ROWS  ON  PAGF 

The  number  ot  vertical  boxes  specified 
conflicts  with  the  number  of  rows  per 
cage  specified. 

399 

CLEP 

NEITHER  DATA-FLOW  NOR  STRUCTURE  WAS 
SPECIFIED 

Either  DATA-FLOW  jr  STRUCTURE  must  be 
specified  (but  not.  both). 

39D 

CLFP 

NEITHER  FORWARD  NOR  BACKWARD  WAS 

SPFCIFIED 

Either  FORWARD  or  BACKWARD  must  be 
specified  (hut  not  both). 

4^9 

CLEP 

N FIT  HER  UPWARD  NOR  DOWNWARD  WAS  SPECIFIED 
Either  UPWARD  or  DOWNWARD  must  be 
specified  (but  not  both). 

4 Aq 

MAIN  ER 

NAME  NOT  FOUND  IN  DATA  BASE 

410 

FPSUCC 

NAMF  NOT  ACCEPTABLE  TTPE  FOR  EP  REPORT 

The  name  c.iven  does  not  have  the  correct 
name  type  for  this  report.  The  possible 
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name  types  are:  PROCESS,  REAL  WORLD 
ENTITY,  INPUT,  ELEMENT,  CROUP,  OUTPUT, 
ENTITY,  SET,  UNDEFINED. 

411  EPSUCC  LINK  LIMIT  SPECIFIED  WAS  REACHED 

This  is  not  so  much  an  error,  as  a note. 
To  obtain  a aore  complete  Extended 
Picture,  the  maximum  number  of  links  aust 
be  decreased. 

412  EPSUCC  SPARSE  MATRIX  TABLE  OVERFLOW,  PICTURE  NOT 

COMPLETE 

Due  to  software  limitations,  the  Extended 
Picture  could  not  be  completed.  To 
resolve  this,  the  maximum  number  of  links 
must  be  decreased. 

413  REL2  STACK  OVERFLOW,  PICTURE  NOT  COMPLETE 

The  number  of  successors  for  the  input 
name  given  is  too  great.  This  is  a 
software  limitation. 

414  PEL3  STACK  OVERFLOW,  PICTURE  NOT  COMPLETE 

The  number  of  successors  for  the  input 
name  given  is  too  great.  This  is  a 
software  limitation. 

415  CLEP  BOTH  DATA-FLOW  AND  STRUCTURE  SPECIFIED 

Either  DATA-FLOW  or  STRUCTURE  must  be 
specified,  but  not  both. 

416  CLEP  CONFLICTING  PARAMETERS,  FORWARD  AND 

BACKWARD  OR  UPWARD  AND  DOWNWARD 
Either  FORWARD  or  BACKWARD  must  be 
specified,  but  not  both.  The  same 
applies  to  UPWARD  and  DOWNWARD. 


417 

CLPC 

FILE= 

NOT 

ALLOWED  IN  THIS  IMPLEMENTATION 

4 15 

CLEP 

PILE  = 

NOT 

ALLOWED  IN  THIS  IMPLEMENTATION 

428 

COMENT 

DATA 

BASE 

OVERFLOW 

429 

COM  R W 

DATA 

BASE 

OVERFLOW 

430 

NAMCR 

DATA 

BASE 

OVERFLOW 

431 

NUMCR 

DATA 

BASE 

OVERFLOW 

470 

MATNCT 

WARNING  - 

ERRORS  WERE  ENCOUNTERED 

4 R 1 

CLILOP 

INVALID  COMMAND  - 

504 

P3DC0N 

NAME 

NOT  IN  DATA  BASE 
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SQS 

F3DCON 

NAMES  NOT  CONNECTED  IN  TEAT  EA  SHI  ON 

S1 1 

APPLES 

TRACE-KEY  CANNOT  APPLY  TO  TRACE-KEY 

S 1 2 

PWLIST 

CANNOT  HAVE  TRACE-KEY  FOR  TRACE-KEY 

sn 

ASSERT 

TOO  MANY  TFIPLES,  REST  IK  THIS  STMT 
IGNORED 

S 1 4 

RWLTS2 

ALREADY  GIVEN  WITH  DIFFERENT  ATTRIBUTE 
VALUE 

sis 

UNAS  Rm 

NAMES  NOT  CONNECTED 

r'21 

DOUPTR 

UNBALANCED  PARENTHESES  IN  SELECTION 

STRING 

S22 

GFTATP 

ATTRIBUTE  DOESN ' T APPLY  TO  ANYTHING 

There  are  no  naaes  which  have  the  given 
ATTPT  BUTE. 

523 

GETNML 

NO  NAMES  WHICH  MATCH  CRITERION 

There  are  no  nanes  in  the  data  ease  which 
satisfy  the  selection  criteria. 

524 

NGPV  A L 

***  SOFTWARE  ERROR 

S 2S 

NGPRS 

NAME  ON  PIGHT  DOES  NOT  MATCH  TYPE  ON  LEFT 

5 25 

NGPRS 

INVALID  SELECTION  STRING 

The  selection  string  given  as  a aaraaetec 
for  the  Naae-Gen  report  is  not.  a leqai 
boolean  expression. 

S?7 

NGPRS 

INVALID  ITEM  IN  SELECTION  STRING 

Thp  itea  given  in  the  selection  string  is 
not  a legal  operand  or  a legal  operator. 

S2<3 

PPEP  AR 

TOO  MANY  ORDER  PARAMETERS 

More  than  five  ORDER  paraaeters  have  been 
given,  or  the  ORDER  paraieters  have  been 
qiven  incorrectly. 

S24 

PREPA R 

NAME  IN  ORDER  LIST  NO  ATTRIBUTE 

The  naae  given  in  the  order  list  is  not 
an  ATTRIBUTE. 

S 3 0 

PREPAP 

NAHF  IN  ORDER  LIST  NOT  IN  DAT*.  BASE 

531 

PREP  AR 

NAMF.  IN  ORDER  LIST  TOO  LONG 

The  naae  qiven  h3s  aore  chan  30 
characters. 
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GETNNR 

NO  NAMES  WHICH  HATCH  CRITERION 

There  are  no  names  in  the  data  base  which 
satisfy  the  selection  criteria. 

533 

NGPRS 

***  SOFTWARE  ERROR 

534 

OPT  M2 

***  SOFTWARE  ERROR 

535 

NGPRS 

TOO  MANY  LEVELS,  MAX  OP  50  ALLOWED 

Too  iany  levels  have  been  specified  via 
the  SUBPARTS-OF  and  SUBLEVEL  pariater. 

553 

CONSM 

NAME  MUST  BE  RESO URCE- USAG E-P A R AH BTER 

5 5 U 

CONSM 

NAME  LIST  TOO  LONG  - REST  IGNORED 

5f  1 

RWLTS2 

INCONSISTENCY  IN  CLASSIFICATION  STATEMENT 

561 

PULI S 2 

INCONSISTENCY  IN  S ECU R TTY  - ACC ESS- R I GHT 
STATEMENT 

66  2 

RWLIS? 

INCONSISTENCY  IN  RESOURCE- USAGE  STATEMENT 

563 

RWLIS2 

INCONSISTENCY  IN 

RESOURCE- US  AGE- PARAMETER- VALUE  STATEMENT 

665 

TGKEY 

SOFTWARE  ERROR  ***  SHOULD  NOT  OCCUR  *** 

569 

RWLIS2 

INCONSISTENCY  IN  CONSUHES/CONSUMED 
STATEMENT 
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ID.  HOW  TO  CORPECT  ERRORS 

Once  error  situations  are  detected,  there  Bust  be  sane  aethod  to 
deal  with  then.  when  the  errors  are  caused  by  problaas  in 
qeneratinq  a report,  no  action  need  be  taken  as  no  hara  sill 
come  to  the  da*-a  base.  The  Report  Coaaand  can  slaply  be 
restated  in  correct  format  to  solve  the  problea.  If,  however, 
an  error  is  encount?red  in  making  modifications  to  the  data  base 
(via  Modifier  Commands)  then  soae  immediate  action  should  be 
taken  if  the  problem  definer  desires  to  maintain  a corract  and 
complete  problem  statement. 

The  errors  discovered  in  making  modifications  to  the  data  base 
can  he  "Input  Errors"  which  are  errors  discovered  by  URA  in  its 
attempt  to  process  the  information  needed  to  update  the  data 
base,  All  these  errors  are  specified  by  one  or  more  URA  error 
messages.  The  malority  of  these  errors  occur  in  the  process  of 
usinq  the  THPUT-PSL  command. 

The  errors  discovered  in  the  problem  statement  by  the  problem 
definer  are  called  "Loqical  Frrors,"  Ho  ercoL  diagnostics  are 
qenerated  by  URA  to  denote  that  an  error  has  occurred.  If  a 
name  was  misspelled  in  the  input  information  used  for  INPUT-PSL, 
the  name  could  be  leqal  bv  URL/URA  conventions  yet  sot  correct 
from  the  problem  definer's  standpoint.  "BATCH"  and  "BATHC"  are 
both  names  that  would  be  perfectly  acceptable  to  URA  but  not  to 
the  problem  definer. 

Th»  following  two  sections  deal  with  aiding  the  problem  definer 
in  correcting  both  Input  Frrors  and  Loqical  Errors  should  they 
occur.  Treatment  of  the  error  correction  methodology  is  still 
at  a cursory  level  and  no  attempt  is  made  to  present  procedures 
to  correct  all  possible  errors. 


K.  1 In£ut  Erro£s 

As  stated  before,  all  input  errors  cause  UFA  error  diagnostics 
to  be  printed.  There  are  a few  classes  of  errors  which  happen 
again  and  again  and  so  will  be  described  below. 


Inconsistent  Pat  2 

This  error  is  usually  identified  by  getting  the  URA  error: 

"fJR  A 770  j IUPAR;  E°R  0 P OPFUNG  DA’i'A  BASE."  This  error  might 
occur  after  issuing  a URA  Modifier  or  Report  Command  and  it 
specifies  that  the  contents  of  the  file  being  used  as  a URA  data 
base  cannot  be  accessed  by  the  UFA  software.  Mathods  for 
correcting  this  sitjation  are  installation-dependent  since  it 
Involves  the  manner  in  which  files  ate  created  and  initialized. 
See  section  10.1  of  Part  IT  for  solutions  to  this  problam  at  a 
particular  installation. 
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!2£*  italsfen  t 5££2t5 

These  errors  account  for  th?  malority  of  the  errors  encountered 
when  Inputting  information  into  ♦he  data  base  via  INPUT-PSL. 
These  errors  ara  caused  by  leproper  use  of  HR L stateeents 
according  to  the  rules  specified  in  the  "User  Requirements 
Language,  Version  3.2,  Lanquage  Reference  Manual."1  An 
occurrence  of  any  of  these  errors  results  in  the  statement, 
where  the  error  occurred,  beinq  iqnored  by  the  system. 

Th«  "t"  character  printed  by  URA  is  usually  fairly  close  in 
pointinq  out  where  the  error  occurred.  Some  of  the  more  common 
errors  (and  solutions)  are  presented  here  in  hopes  that  the 
users  will  be  able  to  apply  the  methods  of  solvinq  thesa  errors 
to  th»ir  own,  specific  needs. 

O 2 mill  £rr2£s 

These  errors  are  often  encountered  throuqh  misspellings, 
improper  forma*-  of  *he  statement  or  improper  usage  of  URL 
reserved  words.  'IRA  usually  generates  either  of  the  two  error 
messages: 

'I  RAO  10;  P ED'IT  E : NO  APPLICABLE  PRODUCTION-SYNTAX  ERROR-START 
SNIPPING 


UR  AC  1 1 : STACK  : TLI.FGAl  SYMBOL  PAIR-SYNTAX  FRROR-START  SKIPPING 
For  example,  if  upon  misspelling  the  RECEIVES  statement: 

FFCFIVFS  POLPER-A,  FOLPER-B; 

,,D A will  react  bv  printing  the  URA010  error  message  and  skip 
that  statement  to  go  on  to  the  next.  There  are  some  further 
problems  that  can  then  occur.  If  the  error  occurred  in  a header 
statement,  such  as  PROCESS,  then  the  header  statement  is  skipped 
and  all  statements  intended  to  be  related  to  the  header 
statement  will  be  related  to  the  previous  header  statemant. 
when  a reserved  worl  is  misspelled,  I1RA  has  no  way  of  knowing  if 
the  statement  was  to  be  a header  statement  or  not.  Take  the 
example; 

GROUP:  31; 

CSTS:  El,  E2,  G2 ; 

PROCCESS;  pi; 

RCVS ; II,  12; 

SUSP  ARTS:  P2,  P3; 

FLENENT:  El,  E2; 
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PPOCESS  has  been  mi r,s pel  1 ed  which  results  in  having  that  header 
stateaent  skipped.  All  the  statements  following  this  header  are 
related  to  the  previous  header  which  leads  to  aore  probleas 
since  statements  which  can  only  he  associated  to  a PROCESS  are 
being  attributed  to  a GROUP  name.  Hore  errors  will  occur  froa 
this  resulting:  hence,  the  PROCESS,  RCVS  and  SOBPARTS  stateaents 
will  not  be  entered  into  the  data  base.  To  correct  this  error, 
the  statements  that  were  oaitted  could  be  entered  by  another 
IVPUT-PSL  coaaand.  A far  more  serious  problem  occurs  if  the 
"previous"  header  was  also  a PROCESS . For  example: 

PPOCESS  PX; 

RCVS:  Id,  II; 

GENS:  M,  3 2; 

PROTCESS  PI; 

RCVS  II,  12; 

SUBPARTS  P2,  P.1 ; 

ELEWFN'r  El,  E 2; 

Tf  this  were  the  case,  then  only  one  error  would  be  caught  by 
URA  (the  misspelled  "PROCESS")  and  the  following  RCVS  and 
SUSP  APTS  Statements  would  be  attributed  to  PROCESS  PX.  If  this 
mistake  were  discovered,  the  user  would  have  to  delete  the  two 
statements  from  PX  and  then  reinput  the  information  for  Pi; 

DELETE-PSI. 

PROCESS  PX; 

RCVS  11,12; 

SUBPARTS  P2,P3; 

EOF 

TNPUT-PSL  UPDATE 

PROCESS  PI; 

RCVS  11,12; 

SU3P  A pTS  P2, P 3 ; 

EOE 


i i)  Illegal  Statement 

This  error  is  designated  by  the  UFA  error: 

URA26S;  I LIST : ILLEGAL  S'f'ATENENT  IN  THIS  SECTION 

This  error  can  be  caused  simply  by  using  a statement  that  is  not 
allowed  for  that  particular  section.  Using  a CONSISTS  statement 
in  a PROCESS  section  would  obviously  generate  this  error.  The 
other  case  occurs  when  an  error  is  made  in  a header  section 
statement  and  all  the  following  statements  might  be  incompatible 
with  the  previous  header  section  name.  Whenever  this  error  is 
encountered,  the  statement  is  not  put  into  the  data  base. 


I i i ) 111 egal  Header  Stateaent 
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If  an  error  occirs  in  a header  statement  and  URA  is  able  to 
identify  it  as  a header  statement,  the  following  ercor  will  be 
q i ye  n : 

URAl  2*>:HEAD:  INVAIID  HFAPEP  STATEHFNT-STATBMENTS  will  bb  ignored 

■’'his  means  ♦■hat  all  »he  statements  up  to  the  next  header 
statement  will  he  ignored  and  not  input  into  the  data  base.  All 
the  statements  iqnored  aust  be  reinputted  using  another 
TNPnt-PSL  roiaan  1 to  be  put  into  the  data  base. 


ivl  lB£ut  tine  Too  L ong 

If  a nuaher  of  URL  stateaents  are  used  on  one  line  of  the  input 
file  or  if  the  URL  statement  is  very  lonq,  it  may  run  over  the 
7?  column  restriction.  Should  this  occur,  usually  URA010  or 
U»A0  11  will  be  generated  specifying  that  improper  syntai  has 
been  encountered.  Mote  that  no  error  message  is  generated  for 
♦•he  fact  that  the  statement  runs  over  the  72  column  restriction. 
Frnrs  are  encountered  because  anythinq  over  column  72  is 
ignored.  "herpf o[“,  names  may  be  truncated  or  a seiicolon  lost. 


v)  Name  Too  Long 

Tt  is  an  easy  thing  to  mistake  a 31  or  32  character  word  for  30 
characters.  Names  longer  than  30  characters  are  cauqht  by  (JRA 
and  flaqqed  by  the  error: 

n R A00  2 : NLE X : N AN  F TOO  LONG 

Th e statement  that  used  the  name  is  still  entered  into  the  data 
base  but  the  name  is  stored  in  a truncated  form  in  the  data 
base.  if  the  truncated  form  of  the  name  is  not  satisfactory,  it 
is  a simnle  matter  to  change  the  name  via  the  RENAME  command. 


vi ) using  on  A Reserved  Herds  Incorrectly 

Most  santai  errors  are  fairly  easy  to  detect;  a misspelled  word, 
improper  format,  etc.,  but  one  of  the  hardest  to  detect  is  the 
improper  use  of  a U*l  reserved  word.  For  example,  the  following 
statement  would  be  tlaqqed  by  a tlRADTO  or  URAOO  error  massage  as 
having  a syntax  error: 


ATTRIBUTE  TYPE  A; 

The  letter  "A"  happens  to  be  a URL  optional  word  and  cannot  be 
used  as  a user-defined  name.  Detecting  these  reserved  words  can 
get  trickier  than  this,  however,  as  the  statment: 

PROCESS  P,F,G,K; 
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seeis  correct,  hut  "F"  is  the  abbreviation  of  the  URL  reserved 
word  "FALSE."  The  hey  to  finding  these  errors  is  to  natch  where 
the  character  is  printed  by  UFA.  It  is  usually  printed 

directly  after  the  location  of  the  source  of  the  error.  The 
statement  is  iqnored  should  this  type  of  error  occur  and  the 
only  solution  is  to  reinput  the  data  usinq  a different,  name.  A 
list  of  all  URL  reserved  words  is  given  in  Appendix  B of  the 
"User  Requirements  language,  Languaqe  Reference  Manual. " * 


v i i)  5 vp  ony  a Too  Complicate! 

This  error  is  specified  by  th-»  UR  A error: 

URA 2*6: SETS y Nr  UNABLE  TO  HAKF  SYNONYrt-TOO  COMPLICATED 

This  is  caused  by  specifying  various  relationships  about  two 
names  and  then  attempting  to  make  one  a SYNONYM  of  the  other. 
The  problem  lies  in  combining  these  relationships.  The 
s*-at  emen  ts: 

GROUP  G 1 ; 

USED  BY  P2; 

PROCESS  LONG-PROCESS-NA ME; 

SUBP ARTS  PI, PU: 

SYNONYM  P2 ; 

will  qenerate  the  error.  P2  is  implicitly  defined  to  be  a 
PROCESS  lust  in  the  context  in  which  it  is  used  in  the  second 
statement;  it  also  has  a relationship  with  Gl.  Now 
LONG - PPOCESS - NAM  E is  defined  and  has  relationships  formed  with 
P3  and  P 4 . In  the  last  statement,  an  attempt  was  made  to  make 
P2  and  LONG- PROC ESS - N AM F the  same  PROCESS  and  the  error  is 
generated.  The  whole  probLem  could  have  been  avoided  if  the 
us«r  ha*  maintained  the  convention  of  issuing  SYNONYM  statement 
directly  after  the  header  statement  as  shown  below: 

GROUP  Gl ; 

USED  BY  P2; 

PROCESS  LONl-PROCESS-NAME; 

SYNONYM  P2; 

SUBPART'5  P3;P4; 

If  the  statements  had  been  inputted  in  this  manner,  LONG- 
PROG  t’SS- NAME  would  not  have  had  any  relationships  formed  with 
other  names  (f»3  and  pu  in  the  previous  example)  and  the 
assignment  of  R2  as  a SYNONYM  would  have  been  successful. 


• Part  II,  URL  User's  Manual. 


Part  I User  Requirements  Anal vter 


H6180/Hultics/URA  User's  Manual 


75 


Since  the  error  does  occur,  there  exists  a aethod  of  correcting 

this  problem: 

1)  Retrieve  all  information  for  one  of  the  names  via  the  PURC1 
parameter  for  the  EPS  command. 

2)  Delete  the  name  for  which  the  information  was  retrieved 
from  the  data  base. 

3)  Altec  the  PUNCH  information  so  that  all  the  information  now 
pertains  to  the  name  still  in  the  data  base. 

4)  enter  the  modified  PUNCH  information  as  input  to  the 
TNPUT-PSL  command. 


In  this  way,  all  information  about  P2  is  given  to 
LONO-PROCESS-NAME  and  P2  is  assigned  as  a STNONTH  if  future 
references  to  the  name  are  necessary.  It  is  much  easier  to 
maintain  the  convention  of  assigning  SYNONYMS  directly  after  the 
header  statement. 


viii)  Names  Used  in  Wrong  Context 

'"his  type  of  error  accounts  for  the  majority  of  the  error 
messages  presented  in  Section  9. 

URA2D2:NLTSr : NAME  PREVIOUSLY  USED  D I FPER ENTL Y- 1 S NOR  ED 

is  an  example  of  diagnostics  presented  for  this  type  of  error. 
The  statement  will  be  ignored  and  the  only  way  to  resolve  the 
problem  is  to  reinput  the  information  in  an  acceptable  format. 


ix)  Breaking  Sect  ion /Statement  Pules 

Several  error  messages  can  be  generated  by  attempting  to  break 
the  rules  set  for*h  in  the  "User  Reguirements  Language,  Version 
4.C,  Language  Reference  Manual,"'  for  statements  within  a 
particular  section.  Tn  using  the  PART  statement,  for  example, 
an  object  may  b?  PART  of  only  one  object  and  failure  to  comply 
with  this  rule  will  result  in: 

n»A061 : RWLIST:  ALREADY  PART  OF  SOMETHIN 3 ELSE 

or  some  analogous  URA  error  message.  These  error  checks  are 
made  to  enforce  the  rules  set  forth  in  the  "Language  Reference 
Manual"  and  ensure  that  the  problem  statement  is  still 
meaningful.  Other  messages  presented  for  this  type  of  error 
aret 
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URA2 1 U: OTHER  S : CONNECTIVITY  ALREADY  GIVEN  POR  THIS  R ELAT  ION 
or, 

flRA06b : APPLES:  SECOND  HAILBOX  FOR  PD  ILLEGAL 

Tf  the  user  wishes  to  replace  the  inforaation  state!  in  the  data 
hasp,  e.q.,  replace  the  MAILBOX  for  a problem  detiner,  the 
relationship  shoull  be  delete!  via  DELETE-^SL  and  then  the 
correct  inforaation  should  be  inputted  using  the  INPUT-  PSL 
coma  and . 


10.2  Logical  Err  or  s 

Theso  errors  occur  when  inputting  inforaation  into  the  lata  base 
(as  input  errors  do)  , but.  no  diagnostics  are  given  in  the  AS-tS 
SOURCE  LISTING.  These  errors  aight  be  detected  by  scanning  the 
complete  list  of  names  in  the  data  base  (NAN  E-GEN ) and  the 
complete  problem  statement  ( FORMATTED- PR  OBI.EH-srATEHFNT)  . Thes* 
errors  can  also  be  letected  when  reviewing  the  contents  of  any 
of  the  other  reports  available  on  URA. 


r 


i 


2l25££lled  Names 

A siaple  spelling  error  can  result  in  two  naaes  which  look  very 
similar,  but  which  are  treated  as  two  different  objects  in  the 
data  base. 

For  example,  if  the  name,  "C AL FN PAR-DA Y"  was  used  to  specify  a 
particular  INTERVAL  in  the  data  base  and  then  "CALENDAR-DAYS"  is 
used  in  the  statements. 

INTFRVAI  : CA1  FNDAP-week  ; 

CONSISTS:  7 CALENDAR-DAYS; 

the  two  names  become  completely  different  ohlects  (to  URA).  URA 
loos  not  know  that  the  two  are  the  same  object  and  it  is  up  to 
the  user  to  detect  and  correct  this  mistake  which  can  be  done  in 
the  following  manner. 

1)  Retrieve  ill  information  for  one  of  the  naaes  via  the  PUNC1 
parameter  for  the  FPS  command. 

2)  Delete  the  name  tor  which  the  information  was  retrieved 
from  the  data  base. 


I 


i 

i 


Alter  the  PUNCH  information  so  that  all  the  information  now 
pertains  to  the  name  still  in  the  lata  base. 

Enter  the  modified  PUNCH  information  as  Input  to  the 
IN PUT- PS L command. 
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”he  effect  af  doinq  this  for  the  previous  example  Mould  be  that: 

i)  All  information  qiven  about  CALENDAR-DAYS  is  transferred  to 
CALENDAR-PAT  and  then  CARLENDAR-DATS  is  deleted  from  the 
data  base.  If  it  is  desirable  to  use  the  plural  fora  of 
the  name  in  the  data  base  then  it  should  be  a SYNONYM,  this 
can  be  done  in  a DESIGNATE  statement: 

INPOT-PSL 

PFSG  CAIENOAR-D AYS  SYNONYM  C A LFNDAR -DAY ; 

FOF 

ii)  Since  names  cm  consist  of  letters  or  numbers,  and  certain 
special  characters,  another  coamon  misspellinq  error  is  to 
substitute  the  letter  "0"  for  the  number  "D".  It  is  often 
very  difficult  to  detect  this  and  so  there  appear  to  be  two 
names,  spelled  exactly  the  same  in  the  data  base.  This  can 
be  corrected  in  the  same  way  as  the  previous  problem. 

iii)  when  the  spellinq  error  only  involves  one  name  (if 
TIME-CARD  vas  spelled  TIMECARD  in  all  instances)  then  this 
problem  could  easily  be  solved  by  using  the  RENAME  command: 

RENAME  0=TI MECA  RD  N=TIME-CARD 

If  both  TTME-CARD  and  TIMECARD  are  defined  in  the  data 
base,  then  the  same  procedure  used  to  change  CALENDAR-DAYS 
must  be  performed. 


Redundant 

Another  error  Mh  ich  occurs  quite  frequently  is  to  define  one 
object  by  t mo  different  names,  not  realising  that  they  ire 
representing  the  same  thing.  EMPLOYEE-RECORD  aid  EMPLOYEE-DATA 
may  be  defiled  separately  in  the  data  base,  but  represent  the 
same  thing.  To  resolve  this  redundancy,  the  information  for  tha 
two  names  must  be  combined.  This  can  be  done  in  the  sale  manner 
as  qiven  for  correct inq  the  misspelled  names  (involving  two 
names)  . 


M iss jrq  Semicolons 

Most  often,  a missing  semicolon  will  be  detected  as  a syntax 
error  (as  described  in  section  10.1).  There  is  one  particular 
case  where  a missiny  semicolon  would  not  generate  any  error 
message: 

PROCESS  PI; 

DESCRIPTION; 

THIS  IS  A DESCRIPTION  COMMENT  ENTRY  THAT  IS  MISSIES 
THE  SEMICOLON. 

EC  VS  II, 12; 
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RENS  01, 02; 

What  happens  here  is  that  the  RCVS  statement  becomes  part  of  the 
DESCRIPTION  comment  entry.  A semicolon  w as  omitted  in 
terminating  the  lines  intended  to  be  the  comment  entry,  but  HRA 
simply  searches  for  the  first  semicolon  to  signify  the  end  of 
th*»  coeeent  entry.  To  solve  this  problem  the  DESCRIPTI3N 
statement  mist  be  replaced  rnd  the  RCVS  statement  must  he  added 
to  the  data  base.  This  can  be  accomplished  by  the  following 
procedure. 

1)  Generate  the  incorrect  comment  entry  in  the  fora  of  PUNCH 
information  (via  the  PUNCH-COHNENT-BNTRY  command) . 

2)  Alter  the  PUN2H  information  so  that  the  comment  entry  is 
correct . 

d)  Use  the  modified  PUNCH  information  as  input,  to  the 
RFPLA3E-CO*1  ‘(FNT-ENTR  Y command. 

4)  Add  the  RCVS  statement  via  an  YNPUT-PSL  command. 


Con  oct n os  . and  Completeness 

Tor  the  nor,*  oart,  it  is  up  to  the  problem  definec  to  maintain 
correctness  of  the  problem  statement  and  URA  maintains 
correctness  of  the  lata  base.  The  problem  detiner  has  the 
ability  to  do  this  throuqh  usage  of  the  DELETF-PSL  tnd  INPUT-PSl 
commands.  Completeness  can  also  he  determined  by  the  problem 
definer  or  improve!  throuqh  use  of  the  INPUT-PSL  command. 
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1.  INTRODUCTION 

UPA  extracts  inform tion  from  URL  statements  and  stores  it  in  a 
UFA  data  base.  Onca  this  information  (a  requiranents  stateaentt 
is  in  the  data  base,  it  can  be  Modified,  new  information  can  be 
added  to  it,  and  reports  can  be  generated  presenting  the  status 
of  the  requirements  statement.  These  actions  are  impleaented  bf 
the  UPA  commands  available  in  the  URA  processing  mole.'  This 
mode  of  operation  my  be  attained  by  accessing  the  URA  software 
available  under  Unities.  Therefore,  by  understanding  the 
Hultics  commands  that  aid  in  interacting  with  UFA,  and  the  URA 
command  language,  the  URA  user  can  effectively  manipulate  the 
contents  of  a 'IRA  data  hase. 

The  format  of  this  part  serves  an  important  purpose.  The  first 
five  sections  deni  with  Unities  and  URA  at  an  introductory 
level.  Section  2 presents  necessary  information  for  reference 
to  Hultics  operating  system.  Section  3 explains  the  procedure 
of  accessing  UPA  once  on  Hultics.  Sections  4 and  S present, 
practical  concents  and  conventions  which  aid  in  using  ORA  under 
Mult  ics,  Once  access  to  Up.A  has  been  achieved,  Sections  f , 7 
and  8 present  the  manner  in  which  Hultics  interacts  with  the 
various  commands.  several  oxamples  are  given  in  those  sections 
in  order  to  better  illustrate  the  results  of  specific 
implementations.  Section  <*  deals  with  using  Unities  to  handle 
errors  encountered  in  the  use  ora.  in  this  chapter,  tha  Hultics 
naming  conventions  are  used,  hence,  all  Hultics  and  URA  commands 
appear  in  lower  case. 


2.  11  SI  NT,  HULTICS 

An  excellent  tutorial  on  the  use  of  Hultics  can  be  founl  in  the 
User  ' s Honeywell  Order  Number  AL<0  and  reference 

material  will  be  found  in  the  Hultics  Programmer's  Manuals.  The 
remaining  sections  in  this  chapter  assume  a familiarity  with  tha 
Hultics  command  language. 


3.  THF  URA  EN VI  RON H F NT 

Assuming  that  the  user  is  already  loqged  into  Hultics,  he  shoull 
first,  gain  access  to  all  upa  software  which  is  contained  in  the 
URA  directory.  The  user  may  do  this  by  adding  the  URA  directory 
to  his  search  rules  after  his  working  directory.  The  following 
command  shoud  be  used: 

asr  >ml>C ARA  -after  working_dir 


* A processing  mode  is  defined  by  the  software  system  in  control 
wher  anv  type  of  command  is  issued.  The  debug,  facility,  the 
editor,  UPA,  etc.  all  define  processinci  modes  and  thus,  a 
particular  set  of  commands. 
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A UP  A data  base  with  the  naie  uradb  »ay  be  initialized  by  the 
following  coeeand: 

exec_com  >ni>C ARA>initdb  uradb 

This  will  create  an  eepty  initialized  data  base  of  the  iefault 
size  in  the  current  working  directory.  To  create  a data  base 
with  a non-default  size  see  Appendix  B for  creating  data  bases. 

One*  a da*a  base  has  been  initialized,  the  user  nay  enter  UFA 
mole  with  the  Hultics  command: 

exec_.com  >el>CARA>ura 

This  command  is  used  whenever  the  user  wishes  to  enter  BRA  aode, 
whereas  a data  base  need  only  be  initialized  at  the  beginning  of 
a project.  Should  a user  desire  to  expand  or  reorganize  his 
data  base,  the  dunp/testore  prograas  described  in  Appendix  C aay 
be  used. 


4.  ^PFCIPYINO  INPUT  TO  rjRA  COWHANDS 

This  section  specifies  inforaation  relavant  to  using  and 
manipulating  Hultics  segments  to  be  used  as  input  files  to  ORA 
commands.  The  "input”  and  "file"  parameters  of  ORA  coaaands  may 
be  used  with  standard  Hultics  segments  or  input  aay  be  specified 
as  coming  from  the  terminal  in  an  interactive  aode. 


4.1  Entering  Dat a into  a pat  a Set 

Osing  one  of  the  Hultics  editors,  the  user  can  create  segments 
to  be  used  with  the  "input"  and  "file"  parameters.  Such 
segments  aav  contain  names,  ORL  statements,  etc. 

If  the  user  has  ORL  statements  in  the  segment  named 

mos. input. psl  in  the  current  working  directory,  he  aay  use  it  as 

input  for  the  ip  command  as  follows: 

ip  i nput=mos. input. psl  update 


4.2  Specifying  Input  Data  Interact ivelv 

It  is  usually  advantageous  to  enter  data  into  segments  before  it 
is  used  as  input  to  URA  as  the  user  may  correct  errors  and 
oaissions  without  difficulty  using  the  Hultics  editor.  There 
are  times  when  the  user  may  wish  to  enter  data  directly  to  the 
Analyzer.  In  such  cases,  the  user  specifies  "tern"  instead  of 
the  segment  name.  For  exaaple,  to  provide  input  via  the 
terminal  for  the  ip  command,  use: 
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ip  input*tera  update 


5.  PFCEIVIMG  OUTPUT  FROM  UR  A COARANDS 

This  section  specifies  inforantion  relevant  to  using  and 
Manipulating  Nultics  segaents  to  he  used  as  output  for  J R A 
coaaands.  In  Aultics,  output  files  are  specified  in  tha  output 
naraaeter  of  tha  URA  set  coaatnd,  and  via  the  punch  paraaeter 
for  other  URA  coaands. 


5.1  Using  tt®  fasaaeter 

The  output  pnraaotar  in  the  nR A set  coaaand  allows  the  problem 
definer  to  specify  where  all  reports  generated  by  URA  coaaands 
are  to  he  printed.  If  nothing  is  specified,  all  output  is  sent 
to  the  terainal.  To  specify  that  output  is  to  be  sent  to  a 
seqa  ent : 


set  output = sequent- name 

Prom  this  ooint,  all  reports  generated  by  URA  will  be  written 
into  this  sequent.  The  report  output  nay  ba  reassigned  to  the 
terainal  by: 


set  output*tera 


^ . 2 Usi n g Pinch  Segjeijts 

For  soae  coaaanis,  a punch  file  is  produced.  If  the  usar  does 
not  explicitly  assign  the  punch  file,  a default  segaent  name 
will  he  usel.  Th^se  default  segaent  naaes  are  given  in  Appenlix 


6.  CONTROL  COMMANDS 

These  coaaands  control  the  operation  of  UFA  in  soae  way  without 
actually  causing  any  output  themselves. 

6.  1 Set.  Coaaand 

•"he  most  cotiaon  use  of  this  coamand  is  to  change  the  default 
da*-a  base,  or  to  reroute  *he  report  output.  To  change  the  data 
base  to  be  used  on  subsequent  coaaands: 

set  dhadata-base-segaent-naau 
5.2  Display  £oai§nd 
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This  cossand  displays  the  current  settings  of  global  switches 
and  paraseters  set  using  the  SET  cossand  or  sorely  defaulted  to. 

For  exasple,  if  the  user  wishes  to  display  the  settings  of  all 
switches  and  oaraneters.  he  should  type: 

display  all 

To  check  the  current  data  base  setting,  he  should  type: 

display  db 


*•  3 Stfip  £2H20<! 

This  roenand  returns  the  user  to  Hultics  cossand  node.  All 
paraseters  changed  via  the  URA  set  cossand  return  to  their 
default  values. 


7.  MODIFIER  COM  MAUDS 


chanqe-tyno 

delete 

delete-cossent- entry 
del ete- psl 
input-psl 

punch- consent- an  try 
renase 

re  p lace-  con  n en  t - en  t r y 


R.  REPORT  COMMANDS 


consist- cos  pari  son 

consist  satrlx 

con  tent  s 

dat  a-process 

diet  ionary 

ent ity- identifier 

ext  ended-pictur e 

for sat t ed-probles-st atenent 

frequency 

kwic 

nase-qen 

nas  e-list 

picture 

print-a ttri but e- values 
process-cha in 
process- input-output 
punch- consent- entry 
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resource-consul ption-analysis 
securit  y-consi3 1 ency-analy sis 
structure 
sue  ear y 


9.  RRROR  CONDITIONS 

In  addition  to  error  coaaents  generated  by  the  URA  systia,  there 
are  occasional  errors  associated  with  the  interaction  between 
the  UR*  systea  and  Multics. 


q*1  Iniiiii  fl£i§aaes 

When  the  user  first  enters  (JR*  node,  he  aay  receive  aessaqes 
froa  nultics  that  "io-switch  does  not  eiist."  These  aay  be 
ignored. 


9.2  Abnoraal  Ter  ■ inn  t j,pp 

If  any  of  the  commands  is  unable  to  terminate  in  the  noraal 
manner,  the  Fortran  monitor  aay  be  entered  before  UR*  has  had  a 
chance  to  close  all  files.  The  Fortran  aonitor  will  ask  the 
user  if  these  files  are  to  be  closed.  In  all  cases,  the  user 
should  answer  "ves." 


9.  3 O^ta  5sje  *Usa3l  CESS 

It  is  possible  for  the  user  to  get  into  a state  where  UR*  cannot 
ODen  his  data  base  because  it  thinks  that  it  is  already  open. 

If  this  happens,  the  user  should  return  to  (lultics  mode,  then 
issue  the  Rultics  coaaand: 

al>Z*R*>closeit 


\ 1 
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1.  INTRODUCTION 

Once  a URL  description  of  an  inforaation  processing  systea  has 
b»en  entered  into  a ORA  data  base  the  user  has  the  option  of 
retrieving  the  stored  inforaation  in  several  different  standard 
foraats  called  URA  reports.  Bach  URA  report  has  particular 
characteristics  with  respect  to  its  purpose,  the  aaount  of 
retrieval  and  analysis  required  to  qenerate  the  report,  the 
inforaation  presented  in  the  report,  the  fornat,  etc.  In  this 
sense,  each  report  can  be  classified  by  its  characteristics  to 
provide  an  overall  description  of  the  report  and  to  aid  in 
deteraininq  hot*  the  report  aay  be  used  to  aid  problea  definers 
in  checking  the  validty  of  the  URL  description  and  to  iaprove  on 
its  coapleteness . 

Only  the  reports  qanerated  by  report  coaaands  will  be  presented 
in  this  paper.  The  reports  generated  by  aodifier  coaaands  are 
described  in  the  "User  Requireaents  Analyzer  User's  Bamal," 

Part  I.  The  aanner  of  specifying  input  to  report  coaaands  is' 
given  in  Section  4 of  Part  I and  Section  4 of  Part  II.  The 
aanner  of  receiving  output  froa  report  coaaands  is  given  in 
Section  5 of  Part  I and  Section  of  Part  II. 

Section  2 of  Part  III  presents  the  objectives  of  URA  reports 
with  respect  to  those  relationships  to  the  logical  systea  design 
process  and  their  advantages  in  the  systea  documentation 
procedure.  Section  3 describes  the  aanner  in  which  inforaation 
is  extracted,  froa  a URA  data  base  to  produce  reports. 

Section  4 presents  several  categories  for  classifying  aad 
describing  URA  reports  based  on  contents,  fornat  and  usage. 
Section  5 consists  of  descriptions  of  each  of  the  standard  URA 
reports  available  in  Version  3.2  of  URA. 


2.  OBJECTS  OP  REPORTS  PROM  A URA  DATA  BASE 


2.1  Purpose  Of  URA  Reports 

■"he  purpose  of  URA  Reports  is  to  present  inforaation  retrieved 
froa  a URA  data  base  (which  contains  the  description  of  a 
particular  svstes)  in  a fornat  which  is  useful  to  persons  who 
are  docuaenting  the  tarqet  systea,  who  desire  to  understand  the 
target  systea,  or  who  are  involved  in  the  design  of  the  target 
syst  ea. 

This  requires  that  the  reports  aust  be  of  various  foraats, 
contain  various  typos  and  levels  of  inforaation,  and  be  oriental 
at  the  various  types  of  user's. 

*tth  respect  to  those  persons  docuaenting  the  target  systea,  the 
reports  aust  present  inforaation  resulting  froa  aodif icn ti ons  to 
the  URA  data  base.  (These  reports  are  presented  in  Part  I.)  In 
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addition,  reports  aust  present  the  status  of  the  URA  data  base 
after  aodif Icatlons  have  been  wade  (i.e. , successful 
aodl  f ications)  . Those  reports  are  basically  the  saae  as  those 
used  by  people  who  desire  to  understand  the  target  systea.  They 
present  selected  portions  of  the  inforaation  in  the  data  base  in 
various  foriats.  A few  particular  reports  aay  also  be  used  to 
aid  those  persons  desiqninq  the  target  systea.  They  usually 
present  the  results  of  extensive  analysis  on  inforaation  in  the 
data  base. 


2.  2 Pola  t ion  of  IJRA  Reports  to  Logical  S vstea  Design 
There  are  two  aa  jor  objectives  in  logical  systea  design: 

- To  produce  a proposed  systea  that  is  the  best  possible  in 
teras  of  what  it  will  cost  to  build,  cost  to  operate  and  what  it 
will  contribute  to  t he  organization. 

- To  ainiaize  the  :ost  and  tiae  to  produce  this  "optiaua"  target 
s vst  e«. 

""he  goal  of  developing  coaputer-aided  methods  for  use  in  logical 
systea  design  is  to  contribute  to  the  above  objectives.  At  the 
present  tiae,  it  is  not  possible  to  achieve  an  optiaua  solution 
for  both  of  these  objectives.  One  contribution  that  can  be  aade 
by  a coaputer-aided  aethod  is  to  iaprove  the  "quality"  of  the 
description  of  the  target  systea.  Quality  is  defined  in  teras 
of  consistency,  unaabiguity  and  coapleteness. 

Consistency  Beans  that  no  stateaents  aade  in  the  description 
contradict,  or  are  incompatible  with,  other  stateaents  and  any 
particular  object  is  referred  to  by  the  saae  naae  throughout  the 
descript  ion. 

(Jnaabiquity  loans  that  stateaents  and  relationships  are  aade  so 
precisely  that  interpretation  is  unifora  by  all  readers. 

Coapleteness  Beans  that  all  necessary  relationships  are  given 
and  no  objects  have  been  oeitted  f roa  the  description. 

The  auality  objectives  can  be  aided  at  three  levels: 

1)  gpA  will  enforce  consistency  and  unaabiguity  through  the 
syntax  analysis  and  reference  checks  aade  when  data  is 
entered  into  the  (IRA  data  base. 

2)  The  (JRA  reports  will  sake  it  easier  for  the  problea  definer 
to  detect  logic  errors  in  the  problea  stateaent,  unresolved 
conditions,  etc. 

1)  Soae  reports  are  available  to  the  problea  definer  to  aid  in 
detecting  i ncoa pleteness  and  inconsistencies  of  the  problea 
stateaent 
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Therefore,  the  first  objective  in  logical  systei  design  can  be 
attained  by  improving  the  quality  of  the  docuaentati on. 

The  second  objective,  that  of  minimizing  design  cost  and  tine, 
is  aided  by  transferring  auch  of  the  clerical  workload  to  the 
coaputer.  The  Analyzer,  UFA,  aaintains  an  up-to-date  record  of 
all  inforaation  collected.  The  preparation  of  this  inforaation 
for  use  by  analysts,  > management,  etc.,  can  be  readily  retrieve! 
at  request. 

To  neet  these  objectives,  URA  offers  three  classes  oc  outputs: 

- Reports  to  aid  the  analyst. 

- Rpports  to  ail  the  project  management. 

- Reports  to  aid  the  desiqner, 

- final  specifications. 

Reports  to  aid  the  analyst  are  basically  those  which  aid  in 
resolvinq  inconsistencies,  ambiquities,  and  i ncoa pleteness  in 
the  loqical  system  design  problem  statement. 

The  reports  of  concern  to  project  manageaent  pertain  to  status 
of  the  project  in  the  form  of  aaount  of  inforaation  entered  into 
the  UFA  data  base,  etc.  The  reports  which  are  of  benefit  to  the 
desiqner  are  those  which  reflect  inconsistencies  and 
i n coapleteness  in  the  problea  statement  which  aust  be  resolved 
in  order  to  develop  a design  for  the  proposed  systea.  They  also 
present  inforaation  in  a manner  that  optimal  or  feasible  designs 
aav  be  formulated . 

The  final  specifications  are  the  end  result  of  the  logical 
system  design  chase  using  URL/URA.  They  express  all  the 
information  in  the  UFA  data  base  in  an  easy-to-read  foraat. 

These  specifications  consist  of  a series  of  URA  reports 
generated  in  a particular  order  and  foraat. 


2.  3 A dvantaqes  2l  Us i ng  URA  Reports 

Tn  contrast  to  manually  produced  documentation,  (i.e., 
handwritten  or  typed,  the  URA  reports  have  several  advantages 
with  respect  to  maintainability,  foraat,  usefulness,  etc.) . 


t Throughout  Part  III,  the  terms  analyst  and  problem 

definer  are  used  synonymously.  The  problea  definer  is  a person 
responsible  for  writing  a systea  description  (or  part  of  one)  in 
URL.  A URA  user  is  a person  who  uses  the  URA  software  to  update 
or  retrieve  information  from  a (JRA  data  base. 


Part  TIT  P R A Outputs 


H61flP/Kultics/URA  riser's  Manual 


89 


lain  tain  abil itv 

All  changes  made  to  the  URL  description  of  an  Information 
Processing  System  are  made  via  the  ORA  data  base.  All 
documentation  (ORA  reports)  produced  from  the  information  in  tha 
data  base  after  a change  is  up-to-date.  There  is  no  need  to 
chanqe  previous  documentation. 

Chanqes  made  to  manually  maintained  descriptions  usually  require 
modification  of  all  existing  sets  of  documentation,  and 
modification  of  each  portion  of  the  documentation  affected  by 
the  chanqe.  This  process  can  cause  serious  errors  in  the 
documentation  or  require  extensive  rewriting  (and  retyping)  of 
the  previous  documentation. 


format 

Fach  URA  report  is  formatted  accordinq  to  the  purpose  of  the 
report,  takinq  into  consideration  the  orientation  of  persons 
intended  to  use  the  report.  Therefore,  information  consisting 
of  many  comolex  relationships  may  be  presented  in  a graphical 
format,  to  make  the  information  easier  to  interpret.  Likewise, 
a matrix  format  may  be  used  to  present  a large  amount  of 
information  at  one  time.  Formats  are  standardized  so  that 
interpretation  is  uniform  by  all  users. 

Formats  of  manually  produced  documentation  are  often  not 
standardized  leading  to  problems  and  conflicts  in 
interpretation.  Presentations  of  large  amounts  of  information 
on  a few  pages  is  often  a problem  because  of  difficulties  in 
completion  and  keeping  the  information  up-to-date. 


Usefulness 

Fach  tjra  report  has  been  designed  for  a particular  purpose, 
i.e.,  to  meet  the  system  documentation  needs  of  one  or  more 
us°rs.  In  an  effort  to  maintain  this,  all  information  in  the 
reDorts  is  presented  in  a well-structured  manner  and  the  reports 
are  designed  to  be  consistent  in  their  presentations. 

Many  manually  produced  documents  are  done  ad  hoc  with  possibly 
no  serious  considerations  on  how  the  documents  may  be  used  to 
benefit  the  system  building  process.  In  addition,  the 
documentation  is  often  difficult  to  use  because  of 
inconsistencies  in  the  manner  in  which  information  is  presented 
and  seemingly  lack  of  organization. 


Avaj lability 

Documentation  can  be  produced  anytime  (on  request)  once 
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inforaation  has  been  stored  in  the  ura  data  basa.  This  reduces 
the  lag  tiae  usually  encountered  in  the  aanual  production  of 
docueentation.  This  peraits  important  decisions  to  be  lade  when 
the  problee  is  encountered  rather  than  "next  week,  when  all  the 
inforaation  is  available."  Physical  production  of  the  reports 
is  very  fast  since  this  is  usually  done  using  a line  printer  or 
tern  Inal . 

Too  often  the  docueentation  is  produced  after  the  fact.  This  is 
esoecially  coanon  if  the  people  are  very  technically  inclined. 
They  would  rather  sit  at  the  terminal  or  write  prograa  code 
rather  than  write  docueentation.  Therefore,  when  docuaentation 
is  needed,  little  is  available  or  the  organization  of  the 
inforaation  makes  it  very  difficult  to  use.  Physical  production 
of  the  docuaentation  then  requires  nany  hours  of  aanual  labor 
behind  pencils  and  typewriters  excluding  the  tiae  and  costs  of 
reproducing  the  original.  (It  is  iaportant  to  note  that  in  aost 
instances  that  docuaentation  produced  in  this  way  is  usually 
out-of-date  by  the  tiae  it  leaves  the  typewriters.) 


Selectivity 

OR A reports  way  be  generated  containing  all  the  inforaation 
known  about  the  target  systea  as  containing  specific  inforaation 
about  one  particular  name  relevant  to  the  description.  This 
capability  allows  the  user  to  see  only  what  is  desired  rather 
than  getting  too  much  or  too  little. 

It  would  be  virtually  inpossible  to  incorporate  all  possible 
coabinations  of  inforaation  in  a annually  produced  systea  in  an 
effort  to  anticipate  any  type  of  request.  Therefore,  the 
description  of  the  target  systea  is  presented  in  a select  number 
of  ways  and  any  inforaation  not  directly  available  aust  be 
desired  from  the  available  information  (assuming  it  is  in  some 
way  desirable). 


AaaLxsis 

TTRA  offers  reports  which  aid  in  checking  completeness  and 
consistency  of  the  problem  statement  as  it  exists  in  the  URA 
data  base.  Many  of  the  reports  present  information  in  a manner 
which  allows  visual- analysis  of  the  information  to  check  for 
these  qualities.  Other  reports  incorporate  these  checks  as  part 
of  the  information  presented  in  the  report  and  is  referred  to  as 
computer-aided  analysis.  (Visual  analysis  implies  that  the 
checks  are  made  by  the  user  where  coaputer-aided  analysis  is 
performed  by  the  computer.) 

In  most  forts  of  manually  produced  documentation  the  formats 
used  make  it  difficult  to  check  for  completeness  and 
inconsistencies  in  the  documentation.  Inconsistencies,  in 
particular,  go  undetected  very  easily  as  a result  of  various 
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spellings  of  the  sane  nane  in  the  description,  (there  one  person 
nay  know  that  all  the  versions  of  the  nane  refer  to  the  sane 
thing,  others  nay  not. 


Extensions 

In  addition  to  the  standard  reports  available  in  a particular 
version  of  URA,  the  users  nay  write  their  own  prograas  which 
generate  reports  to  present  infornation  particular  to  their 
applications  of  UR*.  The  new  reports  can  be  incorporated  into 
any  future  docuaenta tion  packages. 

Manually  produced  docunentation  nay  incorporate  coaplex  reports 
involving  a great  anount  of  conputation  and  analysis  in  its 
production,  but  this  requires  the  sane  anount  of  conputation  and 
analysis  anytine  the  report  is  to  be  presented.  Rather  than 
consuming  the  analyst's  tine  in  producing  the  report,  it  is  nore 
feasible  to  let  the  coaputer  do  it  (and  in  less  tine). 


3.  GENERATION  OF  REPORTS 

All  TIP  A reports  are  produced  by  issuing  connands  to  URA.  All 
connands  available  for  UFA  and  the  reports  generated  by  each  are 
qiven  in  "User  Reguirenent  Analyzer  Connand  Descriptions." 
Descriptions  of  each  report  and  the  nane  (s)  of  the  connand  (s) 
used  to  generate  it  are  given  in  Section  5 of  Part  III. 

3.1  URA  Connand  Language  for  Reports 

"he  programs  which  are  initiated  by  a particular  report  connand, 
retrieve  infornation  from  the  URA  data  base  and  output  it  in 
some  neaningful  foraat.  No  aodifications  are  nade  to  the 
infornation  in  the  data  base;  their  sole  function  is  to  retrieve 
the  infornation  and  display  it  in  some  nanner.  In  the  process 
of  collecting  and  displaying  the  infornation  analysis  nay  be 
done  and  the  results  printed  as  part  of  the  report. 

Most  report  commands  have  one  or  more  parameters  that  nay  be 
used  in  coniunction  with  the  connand  for  one  of  the  following 
purposes ; 

- To  specify  data  to  be  used  as  input  to  the  connand  (Input  data 
parameters)  . 

- To  specify  how  data  used  as  input  is  to  be  interpretted  (Input 
control  paraneters) . 

- To  specify  what  options  the  user  has  in  generating  the  report 
with  respect  to  content  (Output  option  paraneters). 

- To  specify  what  options  the  user  has  in  generating  the  report 
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with  respect  to  foraat  (Output  foraat  paraaetars) . 

The  eannec  of  specifying  coanands  and  their  paraaetars  is  given 
in  Part  IV  and  the  aanner  of  using  the  coaaands  and  paraaetars 
is  given  in  Parts  I and  II. 


3*2  Ecu  lain  It  IlCfiUaU&Q  fid  HE  A Clifi  BISS 

There  are  basically  three  types  of  inforsation  stored  in  a ORA 
data  base. 

1)  Rases  and  types  of  objects  defined  by  the  user. 

2)  Consent  entries  (narrative  and  free  foraat  descriptions  of 
objects) . 

S)  Connections  aaong  objects  and  between  an  object  and  consent 
entry . 

The  first  type  of  inforsation  is  stored  as  naae  records,  the 
second  as  consent  entry  records,  and  the  last  as  NOB  records.* 

Each  URA  report  presents  inforsation  taken  froa  one  or  sore  of 
these  different  types  of  records.  Table  2 gives  the  inforsation 
presented  by  each  report.  In  addition  each  URA  report  say  also 
present  inforsation  derived  froa  the  inforsation  in  one  or  sore 
of  these  different  types  of  records. 

The  aanner  in  which  the  inforsation  is  presented  differs  froa 
one  report  to  another.  The  relationship  between  two  naae 
records  say  be  either  iaplled  by  the  report  foraat  or  explicitly 
defined.  for  example,  the  FORMATTED  PROBLEM  STATEMENT  would 
present  that  "eaployee-addrass"  CONSISTS  of  "street, " "city," 
"state,"  and  "tip-code."  The  CONTENTS  REPORT,  on  the  other  hani 
would  present  this  in  th^  following  foraat: 

^ ea oloyee-address 
2 street 
2 city 
2 state 
2 Tip-code 


Therefore,  there  are  three  najor  aspects  relative  to  what  is 
contained  in  a URA  report: 

1)  What  type  of  inforsation  is  presented: 
a)  Naaes  and  types  of  object 


* See  the  description  of  these  records  as  presented  in  Section  7 
of  Part  I for  a better  understanding  of  the  data  base  structure. 
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b)  Consent  Entries 

c)  Connections  anong  objects  and  between  an  object  and 

consent  entry 

2)  How  the  inf«* nation  is  presented: 

a)  As  taken  fros  the  UR*  data  base 

b)  Derived  fros  information  in  the  data  base 

: 

i)  How  Relationships  are  defined: 

a)  explicitly 

b)  implied 

i 

I 

i 

f 


i 
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S£E2l!  SaiS 

ATTP IPUTE  REPORT 

CONSIST*  CON  PART  SON  HATPIX 

CONSISTS  MATRIX  RFPDPT 

COST  ENTS  REPORT 

DATA  BASF  SUMMARY* 

n*TA  PROCESS  PEPORT 

D TCT IONA  F Y REPORT 

FX’TNDEP  PICTURE 

FORMATTED  PROBLEM  STATEMENT 

FREQUENCY  REPORT 

TDENTIFTFP  I NF^R  MATT  ON  REPORT 

K NIC  INDEX 

NAME  GEN 

NAME  LIST 

picture 

PROCESS  CHAIN 

PROCESS  INPUT/OUTPU^ 

PUNCHED  COMMENT  ENTRIES 
"ESOURCE  CONSUMPTION  ANALYSIS 
SECURITY  CONSISTENCY  ANALYSIS 
STPUCTUF E 


Naae 

Coaaent 

NOB 

Re£ords 

E&t£iS3 

fifi£2E£s 

Yes 

No 

Yes 

Yes 

No 

Yes 

Yes 

NO 

Yes 

Yes 

NO 

Yes 

No 

NO 

No 

Yes 

No 

Yes 

Yes 

Yes 

Yes 

Yes 

No 

Yes 

Yes 

Yes 

Yes 

Yes 

No 

Yes 

Yes 

No 

Yes 

Yes 

No 

No 

Yes 

No 

No 

Yes 

NO 

No 

Yes 

NO 

Yes 

Yes 

NO 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

NO 

Yes 

Yes 

No 

Yes 

Yes 

NO 

Yes 

Table  2 

Types  o f Inforaation  Taken  and  Presented  by  URA  Reports 


* All  inforaation  in  this  report  is  "derived"  from  the 
information  taken  fro*  each  of  the  different  types  of  racords. 
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AXIS  I Mil  Elf 212 


Purpose 

This  report  is  intandod  to  present  the  system  properties  aspect 
of  the  targe*  system  description  with  respect  to  the  ATTRI BHTPS 
defined  and  usel  in  the  description. 


T n forma  * ion  Mesent  ?d 


"he  report  presents,  for  each  ATTRIBUTE  name  used  as  input,  all 
names  in  the  data  base  to  which  the  ATTRIBUTE  applies  aid  the 
associated  A TTRT  BUTE- V ALU  FS  for  the  names.  In  effect,  this 
nr.»s»nts  information  given  by  the  ATTRIBUTE  statement. 


format 

raoh  attribute  name  is  numbered,  1*,  2*,  etc.,  as  it  is 
encountered  as  input  and  printed  on  the  report.  Each  naae  to 
which  a particular  ATTRIBUTE  applies  is  also  numbered. 

The  UR  A statements: 

INPUT:  t ime-card; 

ATTRIBUTE  arrival-type  scheduled; 

would  he  present  ?d  as: 

1*  ATTRIBUTE:  arrival-type 

A PPLI  F S TO:  V ALIIF : 

1 ♦'ime-card  scheduled 

in  the  A "T® T PUT r REPORT  for  the  ATTRIBUTE  ar r iva 1-ty pe.  Given  a 
particular  ATTRIBUTE  name,  the  software  generating  the  report 
searches  the  data  base  for  all  names  the  ATTRIBUTE  APPLIES  to 
(is  connected  to)  and  lists  them  under  the  "APPLIES  TO:"  heading 
in  the  report  with  corresponding  ATTRIBUTE-VALUE  under  the 
"VALUF:"  heading. 

"he  format,  for  the  ATTRIBUTE  REPOPT  is  considered  to  be  a list 
format. 


Option  an  i i!  ter  na» i ves 

The  report  mav  be  generated  for  a single  ATTRIBUTE  name  (via  the 
N A " F parameter)  or  for  a collection  of  ATTRIBUTE  names  specified 
hv  the  user  or  retrieved  via  NA MS-GEN. 
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inaliaia 

Each  name  given  as  input  in  qeneratinq  the  report  aust  be 
checked  that  it  is  an  ATTRIBUTE  naae  before  further  processing 
continues.  The  naae  is  then  printed  on  the  report.  If  the 
innut  naae  is  not  an  ATTRIBUTE  the  aessage: 

in  AC  01: NAINPAV:  NAIF  has  no  usages  as  ATTRIBUTE  FOR  A Nr  THING 

is  printed.  Names  and  corresponding  ATTRIBUTE- VALUES  are  then 
retrieved  pair  by  pair  and  listed  under  the  given  ATTRIBUTE 
until  no  more  pairs  are  found  for  the  ATTRIBUTE. 

The  next  A^TRInUTE  naae  froa  the  input  stream  is  taken  (if  thera 
is  one)  and  the  process  repeats. 


USllfS 

In  many  applications  of  the  use  of  the  Lanquaqe  and  Analyzer, 
certain  attribute  n»aes  aay  bo  designated  as  mandatory  for  a 
description.  for  example,  some  applications  aay  requirs  that 
every  PROCESS  definBd  as  part  of  the  description  aust  bs 
specified  as  b*lnq  either  nanual  or  automated  via  the  ATTRIBUTE 
process- type.  Generation  of  the  ATTRIBUTE  REPORT  for  the  naae 
process-type  allovs  the  analyst  to  determine  if  the  current 
description  is  accurate,  complete  and  consistent  in  this 
respect . 

■"he  report  also  presents  ♦hose  names  vhich  are  logically  relate! 
because  of  common  ATTRIBUTE- VALUES  among  them.  In  the  previous 
example,  there  ver>  t vo  logical  groups,  manual  and  autoiated. 

In  practice  there  are  usually  several  possible  A TTRT BUTB-V ALUES. 


Figure  19  presents  the  output  resulting  from  generating  the 
ATTPTBUTE  REPORT  usinq  the  names  produced  by  NAME-GEN  as  input. 
The  follovinq  Analyzer  commands  were  given: 

NAME-GEN  S« ' ATTRIBUTE' 

PRZN^-ATTR I BUTE- VALUES 
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;225ISTs  comparison  report 


£aEE22£ 

To  nresent  lata  structure  information  for  SET,  INPUT,  OUTPUT, 
PNTT  ""T  and  GROUP  naaes  given  as  input.  The  report  by-passes  all 
intermediate  levels  of  data  structure  and  only  presents  the 
lowest  level  constituents  of  those  naaes  given  as  input. 


Information  Presented 

Structure  information  based  on  CONSISTS  statements  in  the  data 
base  can  be  presented  for  SET,  INPUT,  ENTITY  and  GROUP  names 
given  as  input.  However,  rather  than  presenting  all  levels  of 
the  data  structure,  only  the  highest  and  lowest  levels  are 
nresent  ignoring  all  other  levels.  For  example,  the  structure: 

1 hourly-eaployee-record 
7 employee-name 
3 surname 
3 initial 
3 first-name 

2 °a ployee-ident if icati on-number 
2 social-securit y-number 

might  appear  in  the  CONTENTS  REPOPT  which  presents  all  levels  of 
the  data  structure  for  hourly-eaployee-record.  The  CONSISTS 
COMPARISON  REPORT,  however,  would  present  the  naaes: 

surname 

initial 

firs^-namo 

eaplovee-  id  ent.  i f icat  ion-  number 
social -security -number 

as  the  low  level  components  of  the  data  structure  for 
hourly- employee-  record. 

In  addition  to  the  data  structure  relationships  presented, 
similarities  among  data  structures  are  identified  and  summarized 
in  the  report. 


Form  at 

Tho  first  oart  of  the  report  specifies  those  naaes  given  as 
input-,  but  do  not  have  data  structure  relationships  (CONSIST 
statements).  Two  lists  are  given,  one  giving  all  names  given  as 
input  (and  having  CONSISTS  information)  , and  the  other  giving 
ali  the  low  level  constituents  of  those  naaes  in  the  first  list. 
Next  comes  the  BASIC  CONTENTS  MATRIX  where  each  row  of  the 
matrix  represents  one  of  those  naaes  given  in  the  list  of  low 
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level  constituents  and  each  column  of  the  matrix  represents  one 
of  the  names  given  in  the  list  of  input  naaes.  All  nans  in  the 
list  and  rows  and  colusns  are  numbered  so  that  the 
correspondence  between  a particular  row  or  coluan  and  the  naae 
that  it  represents  Is  one  to  one.  A relationship  between  a naae 
represented  by  a particular  row  and  a naae  represented  by  a 
particular  coluan  is  desiqnated  by  an  asterisk  entry  (•»  at  the 
intersection  of  the  row  and  coluan  in  the  matrix.  A blank  entry 
designates  that  no  such  relationship  exists. 

» second  aa'rix  called  the  CONTENTS  SIMILARITY  MATRIX  is  also 
generated  to  oresent  siailarities  in  the  data  structures  (for 
those  naaes  given  as  input)  and  represented  in  the  BASIC 
CONTENTS  MATRIX.  All  inforaation  in  the  CONTENTS  SIMILARITY 
matrix  is  derived  fcoa  inforaation  presented  in  the  BASIC 
CONTENTS  MATPTX.  All  the  naaes  used  as  input  are  represented  by 
a coluan  nuahor  and  row  nuaber  in  the  matrix.  The  nuabers  are 
the  saae  so  that  anv  given  oblect  is  represented  by  row  I and 
coluan  J.  The  matrix  should  be  read  froa  row  to  coluan  as 
saving:  the  data  oblect  represented  by  row  I has  an  integer 
number  of  low  level  constituents  in  coaaon  with  the  dats  object 
represented  in  coluan  J.  When  I»J,  the  number  of  low  level 
constituents  of  any  object  in  coaaon  with  itself  is  presented. 
This  is,  of  course,  the  total  nuaber  of  constituents  for  that 
giv»n  data  oblect.  The  final  section  of  this  report  is  the 
CONTENTS  SIMILARITY  ANALYSIS  which  presents  those  input  naaes 
that  have  identical  lowest  level  constituents  or  which  are 
strict  subsets  (at  the  lowest  level)  of  other  input  naaes. 


Opt  i,  ops  and  * lLe£.H*Lil®5 

a’o  options  are  available  to  change  format  or  content  of  the 
report. 


i ail  i 

pach  name  given  as  input  is  searched  for  in  the  AnaLyzet  data 
base.  If  the  naae  is  not  found,  the  message: 

9RA271:  EAINCNC:  NAME  NOT  IN  D.B.- 

is  printed  anl  is  not  represented  in  the  matrices. 

'or  each  naae  defined  in  thp  data  base  with  CONSISTS 
information,  it3  components  are  then  found  via  the  CONSISTS 
statement.  If  its  components  have  CONSISTS  inforaation  then  the 
procedure  is  continued  until  only  ELEMENTS  are  encountered 
(which  may  not  have  any  sub-components)  or  no  aore  CONSISTS 
inforaation  can  be  found.  The  lists  of  input  naaes  and  low 
level  constituents  are  then  printed  on  the  report. 

Th^  BASIC  CONTENTS  MATRIX  is  then  printed  out  to  illustrate  the 
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relationships  between  the  names  in  the  two  lists  and  each 
relationship  is  designated  by  an  asterisk. 

The  CONTENTS  SIMILARITY  MATRIX  is  produced  by  counting  the 
n timber  of  column  entries  in  common  between  any  two  rows  of  the 
BASIC  CONTENTS  MATRIX.  The  diagonal  is  produced  by  counting  tha 
total  number  of  asterisks  in  the  BASIC  CONTENTS  MATRIX  for  a 
qiven  row. 

The  COST  ENTS  SIMILARITY  SUMMARY  is  produced  by  inspecting  the 
numerical  values  in  the  CONTENTS  SIMILARITY  MATRIX.  If  a 
Darticular  number  presented  in  the  diagonal  occurs  elsewhere  in 
the  same  row  of  the  matrix,  it  means  that  a particular  name 
(reoresented  by  tha  row)  has  all  of  its  constituents,  ia  coaaon 
with  another  name.  If  the  other  name  has  the  saie  number  of 
constituents,  then  the  data  structures  are  identical.  If  the 
other  name  has  more  constituents,  then  the  first  name  has  a data 
structure  which  is  a subset  of  the  others. 


Usag_e 

■'n®  use  of  the  CONSISTS  COMPARISON  PEPORT  is  to  detect  redundant 
Or  similar  data  structures.  Its  ability  to  do  this  lies  in  its 
nt»senta tion  (ignoring  all  intermediate  levels  of  data 
structure) . 

• 

■phis  aids  the  analvst  in  detectinq  possible  errors  in  the  target 
system  description  and  simplifying  it  should  similarities  in 
structures  occur.  This  is  usually  beneficial  when  the  report  is 
generated  for  all  INPUT,  OUTPUT  and  ENTITY  names  in  the 
description  as  input. 

Th°  report  is  also  beneficial  to  the  system  designer  who  may 
utilize  it  to  optimize  structures  that  the  software  will 
eventually  have  to  access.  Identical  or  similar  structures  for 
different  ENTITIES,  for  example,  may  be  mapped  into  the  same 
type  of  storaqe  structure  to  reduce  complexity  of  the  software. 


Examples 

piqure  20  presents  the  results  of  generating  the  CONSISTS 
COMPARISON  REPOPT  for  all  INPUT  and  OUTPUT  names  in  a particular 
data  base.  The  following  commands  were  used  to  generate  the, 
exam  pie; 

NAME-GEN  S= 'INPUT  OR  OUTPUT' 
CONSISTS-COHPARISION 

Not®  that  the  two  names  empl oyee- inf or mation  and 
paysystem-output » •»  not  included  in  the  matrices  because  they 

do  not  have  CON  information. 
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C2H2ISIS  lAISI] C £££0£T 


£as B22£ 

To  present  the  lata  structure  (as  specified  by  the  CONSISTS 
statements)  , either  above  or  below,  each  SET , INPUT,  OUTPUT, 
PNTTTY,  GROUP  and/or  ELEMFNT  name  given  as  input  is  involved  in. 


lD£2Ifiaii2Q  Pl££2BiS<! 

por  each  name  used  as  input  (which  must  be  a SET,  INPUT,  OUTPUT, 
ENTITY,  GROUP  or  ELEMENT)  the  report  presents  naaes  the  input 
nave  CONSISTS  of  (if  the  report  is  generated  with  the  CONSISTS 
paraaeter  in  effect.)  or  naaes  the  input  naae  is  CONTAINED  in  (if 
the  report  is  generated  with  the  CONTAINED  paraaeter  in  effect). 
*"ake  the  following  structure,  for  example,  and  assuae  that  its 
description  exists  in  an  Analyzer  data  base  in  the  fora  of 
cons ISTS  relationships  between  the  naaes: 


(SET)  ~ 
(FNTTTTVS)  -- 

(GROU  PS)  — 
(ELEMENTS)  -- 


level  1 

level  2 

level  3 

level  4 


If  the  CONSISTS  M ArP I X REPORT  were  generated  for  all  tha  above 
GROUP  naaes,  GP-A,  3P-B,  GR-C,  GR-D  and  GR-E,  and  the  CONSISTS 
paraaeter  was  in  effect,  when  generating  the  report,  the  ELEMENT 
naaes  FT.- A,  EL-B  and  EL-C  would  be  presented  in  the  report.  The 
report  would  also  designate  GR-A  and  GR-E  as  not  having  any 
CONSISTS  information  available. 

If  the  report  was  generating  with  the  CONTAINED  parameter  in 
effect,  and  the  sane  GROUP  naaes  as  input,  the  ENTITY  names 
ENT- A,  FNT-B  and  ENT-C  would  be  presented  in  the  report 

Tn  essence,  the  CONSISTS  MATRIX  REPORT  presents  one  level  above 
or  one  lov»l  below  designated  starting  points  in  the  data 
structures  described  in  an  Analyzer  data  base. 

The  report  could  not  be  generated  for  SET  naaes  with  the 
CONTAINFD  parameter  in  effect  because  the  Language  does  not 
allow  SFTS  to  be  CONTAINFD  in  higher  level  structures. 

Likewise,  the  report  could  not  be  generated  for  ELEMFNT  names 
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with  the  CONSISTS  parameter  in  effect  because  the  Language  does 
not  allow  ELEMENTS  to  CONSIST  of  lower  level  structures. 

The  report  also  presents  statistics  on  the  data  structure 
information  such  as  how  many  low  level  components  a particular 
name  consists  of  or  how  many  structures  it  is  contained  in. 


format 

If  the  CONSISTS  parameter  is  used  when  generating  the  raport, 
anv  names  given  as  input  which  do  not  have  CONSISTS  statements 
as  part,  of  their  descriptions  are  flagged  at  the  beginning  of 
the  report.  If  the  CONTAINED  parameter  is  used,  any  naaes  given 
as  input  which  do  not  have  CONTAINED  statements  as  part  of  their 
descriptions  are  flaciqed. 

Two  lists  of  names  are  then  presented,  one  labeled  ROW  NAMES  and 
the  other  COLUMN  NAMES.  If  the  CONSISTS  parameter  was  used  when 
generating  the  report,  the  names  designated  as  COLUMN  NAMES  are 
those  which  were  given  as  input.  If  the  CONTAINED  parameter  was 
used  when  generating  the  report,  the  names  designated  as  POW 
NAMES  are  those  which  were  given  as  input. 

Tn  any  case,  each  name  under  COLUMNS  NAMES  CONSISTS  of  zero  or 
more  names  under  POW  NAME’S  and  each  name  under  ROW  NAMES  IS 
ODNTMNFO  in  zero  or  more  names  under  COLUMN  NAMES.  A matrix  is 
th^n  printed  to  show  the  relationships  between  the  names 
designated  as  sow  NAMES  (which  ace  represented  by  the  rows  of 
the  matrix)  and  the  names  designated  as  COLUMN  NAMES  (which  ace 
represented  bv  the  columns  of  th«  matrix).  The  rows  and  columns 
of  the  matrix  are  numbered  to  correspond  to  the  number  assiqned 
to  each  name  in  the  list  of  POW  NAMES  and  COLUMN  NAMES, 
respect i v«l y . 

An  asterisk  (*)  entry  at  tha  intersection  of  a particular  row 
and  column  of  the  matrix  designates  that  the  name  represented  by 
the  row  is  CONTAINED  in  the  name  represented  by  the  column. 

Inspection  of  an  entire  row  reveals  all  naaes  that  a particular 
name  (rpprn3en)n)  by  the  row)  is  CONTAINED  in.  Inspection  of  an 
entire  column  reveals  all  names  that  a particular  name 
(represented  by  tha  column)  CONSISTS  of. 

A summary  section  is  also  included  in  the  report  presenting  for 
each  POW  NAME: 

- The  row  it.  was  represented  by  in  the  matrix  (ROW). 

- Its  name  t yoe  (TIP  F)  . 

- The  number  of  * entries  in  its  row  (or  the  number  of  names 
CONTAINING  it)  (COUNT)  . 
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"h**  summary  presents  for  each  COLUMN  NAME: 

- The  coluan  it  was  represented  hy  (COLUMN). 

- Its  naae  tyne  ("YPF)  . 

- "he  nuahoc  of  * entries  in  its  coluan  (or  the  nuaber  of  naaes 
it  consts*?  of)  (count). 

’ho  snaaary  section  for  NOW  and  COLUMN  naaes  is  ordered  in 
decreasing  orler  of  COUNT. 


Dpt^ons  and  jhlte^n^t  j res 

The  report  ius»  be  generate)  using  either  the  CONSISTS  or 
CONTAINED  parametei.  If  the  CONSISTS  parameter  is  used,  all 
naaes  given  as  input  aust  be  SET,  INPUT,  OUTPUT,  ENTITY  and/or 
group  na»«*s.  If  the  CONTAINED  paraaeter  is  used,  all  naaes 
given  as  input  aust  be  INPUT,  OUTPUT,  ENTITY,  GROUP  and/or 
•LEM ENT  naaes. 

■’he  report  aav  be  generated  for  a single  input  naae  (via  the 
name  naraaeter)  or  for  a collection  of  input  naaes  eithac 
specified  by  the  user  or  retrieved  via  NAME-GFN. 


inilms 

Each  naae  given  as  input  is  searched  for  in  the  data  base.  If 
it  is  not  found,  the  message: 

USA''00:  CONCDL:  NAM?  NOT  IN  D.  B.- 


is  printed. 

If  ♦■he  CONSIST?  paraaeter  is  used,  each  naae  given  as  iaput  aust 
h«  checked  that  CONSISTS  information  is  available  far  it.  If  no 
CONSISTS  information  is  available,  the  naae  is  listed  under  the 
message: 

UR  A 11  S N COL  : TPB  FOLLOWING  PO  NOT  CONSIST  OP  ANYTHING: 

"he  components  of  those  input  naaes  which  do  have  CONSISTS 
information  are  found.  The  list  of  all  input  naaes  and  the  list 
of  all  components  are  then  printed  on  the  report, 

Tf  the  CONTAINED  parameter  is  used,  each  naae  given  as  input 
must  be  checked  that  CONTAINED  information  is  available  for  it. 
Tf  no  CONTAINED  information  is  available,  the  naae  is  listed 
under  the  message: 

UPA 111 JCONROW  : THE  FOLLOWING  APT  NOT  CONTAINED  IN  ANYTHING: 
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’’’hose  names  which  t h e input  names  are  CONTAINED  in  are  found. 
The  list  of  all  input  names  and  the  list,  of  names  they  are 
CON’’’ A TVF D in  are  than  printed  on  the  report. 

A matrix  is  printed  out  to  illustrate  the  relationships  between 
the  names  in  the  two  lists  and  each  relationship  is  desiqnated 
hv  an  asterisk. 

A summary  is  than  produced  by  countinq  the  number  of  asterisks 
apnearinq  in  each  row  and  each  column  of  the  matrix. 


Usages 

when  a list  of  FLUENT  and/or  GFOTTP  names  are  given  as  input  to 
'ha  command  producinq  the  report  and  the  CONTAINED  paraaeter  is 
specified,  the  report  aids  the  analyst  by  identifying  which 
O^OUP  and  FLFM^NT  names  are  not  incorporated  into  higher  level 
information  structures.  It  aids  the  physical  systea  designer  by 
determining  utilization  of  ELEMENT  and  GROUP  names  by  the 
logical  information  structures  within  the  target  system 
d^script ion . 

Generating  the  report  (using  the  CONSISTS  parameter)  for  SET, 
INPUT,  P DTP  TIT , ENTITY  and  GROUP  names  determines  which  of  these 
have  identical  structures,  with  respect  to  one  another,  and 
which  are  empty,  i.e.,  have  no  CONSISTS  relationships.  This 
also  identifies  similarities  in  the  structures  for  these  types 
of  names,  analyst  may  then  use  this  information  to 

determine  if  redundant  structures  have  been  defined,  if  the 
description  is  incomplete,  etc. 


Exam nle 

Pigure  21  presents  the  CONSISTS  MATRIX  REPORT  generated  with  the 
CONSISTS  parameter  in  effect  and  using  all  INPUT  and  OUTPUT 
names  in  a particular  data  base  as  input. 

^igure  ??.  presents  the  report  generated  with  the  CONTAINED 
parameter  in  effect  and  using  all  GROUP  names  in  a particular 
data  base  as  input.  The  Analyzer  commands  used  to  generate  this 
example  were: 


NAMF-SEN  S= ' GROUP ' 
CONSISTS-MATPTX  CONTAINED 
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CONTENTS  REPORT 


Purpose 

mo  allow  the  tis=»r  to  view  entire  data  structures  (ail  levels) 
described  in  the  Analyver  data  base  as  inplied  by  the  use  of  the 
CONSISTS  statement. 


Inf o rmat ion  Presented 

"h3  CON"'  EN"C  REPORT  present?  all  lower  levels  of  data  structures 
for  SET,  INPUT,  OUTPUT,  ENTITY  and  GROUP  names  used  as  input. 
(Since  fle,*’?NTs  mav  rot  have  CONSISTS  information  they  cannot  be 
used  as  input  to  produce  the  report.)  All  names  which  the  input 
names  CONSIST  of  are  desiqnated  as  level  2 names;  the  names  that 
♦•he  level  ? names  CONSIST  of  are  desiqnated  as  level  3 names, 
etc. 

The  CONSISTS  statement  allows  network  structures  to  be 
constructed  and  so  ary  qiven  name  may  be  CONTAINED  in  more  than 
r>n«  structure,  an'  at  different  levels  in  the  different 
structures.  '’’he  types  of  names  presented  in  the  structures  will 
be  T N PUm S , 0UTnUTS,  ENTITIES,  GROUPS  and  ELEMENTS. 


format 

parh  name  qiven  as  input  to  the  report  is  identified  by  a number 
d*,  2*,  etc,,  designating  its  position  in  the  list  of  input 
names  and  also  bv  the  number  1 desiqnatinq  it  as  a level  1 name. 
All  names  that  are  part  of  its  structure  are  numbered  1 thouqh  n 
accordinq  *0  its  position  in  the  structure  when  printed  out  and 
also  numbered  according  to  the  name's  relative  level  in  the 
structure.  Fach  lpvel  2,  3 and  so  on  is  indented  to  further 
accent  the  idea  of  structure.  Each  group  of  names  of  a given 
level  number  ar3  CONTAINED  in  the  proceeding  name  of  the  next 
highest  level  number.  (Level  1 is  the  highest  level  nuvber.) 
pnr  example,  th3  following  URL  description; 

ENTITY  hourlv-emnloyee-rocord; 

CONSISTS  employee-name, 

empl  oyee-  id  entificat.  ion -number, 
soci  al-ssecur  ity- number; 

GROUP  employee-name; 

CONSISTS  surname, 
init ial, 
first-name; 
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would  appear  as: 

1*  1 hour ly-employee-record 

1 2 employee-name 

2 3 aurnme 

3 3 Initial 

4 3 first- name 

ft  2 emplny»e-ident.i  f i cat ion-num ber 

ft  2 social-security-number 

in  the  CONTENTS  EEPOFT  if  the  reoort  was  generated  for 
hour  lv-empl  oyee- record.  If  the  report  was  qenerated  for 
p«pl oyee-name  the  followinq  structure  would  appear: 

1*  1 employes- name 

1 2 surname 

2 2 initial 

1 2 first-naee 


Cfitians  ini  AliamUxss 

The  user  eay  restrict  the  number  of  levels  of  the  data 
structures  oresented  when  a numerical  value  is  assigned  to  the 
LEVELS  paraiet<»r.  For  example,  when  LFVELS»2  is  given  only  the 
names  at  levels  one  and  two  of  the  data  structure  are  presented 
in  the  report.  The  report  normally  prints  out  ALL  levels  of  the 
data  structures. 

GROUPS  in  the  structures  which  do  not  CONSIST  of  lower  level 
information  or  those  UNDEFINED  names  in  the  structure  are 
flagged  by  the  message: 

** NO  CONSISTS  FOR  GROUP  OR  UNDEF** 

when  the  NOElag  Darameter  is  used.  An  index  for  the  report  is 
nroduced  when  *he  INDEX  parameter  is  used. 

Security  information  concerning  the  names  printed,  as  specified 
by  the  CLASSIFICATION  statement,  can  be  printed  on  the  report 
when  the  PPI VT-ft  ecu  pity- INFORMATION  parameter  is  used. 

The  report  may  ho  generated  for  a single  input  name  (via  the 
NAME  parameter)  or  for  a collection  of  input  naies  either 
specified  hy  the  user  or  retrieved  via  NAME-GEN. 


*331*212 

®ach  name  given  as  input  is  searched  for  in  the  data  base.  If 
the  name  is  not  found,  the  message: 

MRAOftft:  MAINCONT:  NAME  NOT  FOUND  IN  D.B.- 
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is  printed  and  no  structure  information  is  printed  for  the  name. 

For  each  name  given  as  an  input.,  each  name  which  is  CONSISTS  of 
is  designated  as  a level  2 name  as  it  is  printed  out.  If  this 
level  2 name  CONSISTS  of  any  information,  then  each  name  which 
i*  CONSISTS  of  is  designated  as  a level  3 name  as  it  is  printed 
out.  This  process  continues  until  no  more  CONSISTS 
relationships  are  found  or  the  level  specified  by  the  LEVELS 
parameter  is  reached. 

Names  are  printed  out  as  thpy  are  encountered  in  the  structure. 


Usaje 

por  fhe  analyst,  *ha  renort  presents  information  structures  as 
defined  *y  the  use  of  the  CONSISTS  statement  in  a format  in 
which  the  entir°  structure  can  be  seen.  It  is  usually  most 
beneficial  to  generate  the  CONTENTS  REPORT  for  INPUT,  OUTPUT  anl 
'NTITY  names  in  the  data  base  since  all  ma~jor  information 
constructs  u°  hasad  around  these  types  of  names. 

Completeness  chocks  on  the  structure  information  in  the  data 
hasp  can  be  performed  by  specifying  the  NOFLAG  paraieter  when 
generating  the  report.  Since  all  GROUPS  should  consist  of  other 
information  (by  definition  of  GROUP)  and  UNDEFINED  names  should 
be  resolve),  this  parameter  identifies  these  incomplete  aspects 
of  the  structures. 

For  a complete  set  of  final  specifications  for  a particular 
target  svst°m,  the  report  may  be  generated  to  present  the 
logical  information  structures  to  be  handled  by  the  target.  Foe 
this  purpose  it  is  recommended  that  the  report  be  generated  for 
all  SET  names  with  LFVFLS=2  so  that  the  relationships  atong 
INPUTS,  OUTPUTS  and  FNTITIFS  with  SETS  can  be  presented,  and 
generated  for  all  INPUT,  OUTPUT  and  ENTITY  names  so  that 
structures  b“low  these  names  can  be  viewed.  The  commands  to 
generate  this  information  are: 

N A v F-G EN  S= ' SET ' 

CONTFNTS  LEV  FLS  = 2 

NANF-GEN  S* ' INPUT  DR  OUTPUT  OR  ENTITY'  DRDER=BTTTPE 

CONTFNTS 

the  RYTYPE  option  is  used  so  that  all  names  of  a particular  name 
'vdp  are  defined  together, 

When  the  volume  of  information  which  will  be  presented  by  the 
CON1"  FNTS  REPORT  is  unknown,  it  is  a good  practice  to  be 
conservative  in  specifying  a value  for  LEVELS  rather  than  allow 
LEVELS  to  have  the  value  ALL  and  risk  the  possibility  of 
generating  dozens  of  pages  of  output. 
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I5aa£is§ 

Figuro  23  presents  the  full  data  structure  for  the  naae 
hour  1 y-ewplovee- record.  This  example  was  produced  by  the 
following  conaand: 

CON  TENTS  NANE*hourly-e«plo  yee-report 

pigur»  24  presents  the  data  structures  down  to  level  2 for  ail 
ENTITIES  defined  in  a particular  Analyzer  data  base.  The 
Analyzer  coaaands  used  to  generate  this  exaaple  were: 

NAKF-GEN  S= • ENTITY' 

CONTENTS  I.EVELS=2 
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Dili  DDDCFSS  REPORT 


Purpose 

This  report  shows  the  interaction  between  information  (SETS, 
INPUTS,  OUTPUTS,  FNTITIES,  IPOUPS  and  FLEHENTS)  defined  and  the 
pwocESSfS  defined  for  the  tarqet  system.  It  also  shows  the  data 
dependencies  ,a*onq  PPOCFSSFS  as  implied  by  the  Language 
descriptions  of  ♦he  PPOCFSSES  and  possible  deficiencies  in  the 
descriptions  of  these  PROCESSES. 


Tnforaat  ion  Presented 

rhe  Information  presented  in  ♦his  report  is  slightly  different 
impending  on  whether  the  PA*A  or  PROCESS  parameter  was  used  in 
generating  the  report. 

If  the  TAT*  parameter  is  used  in  qeneratinq  the  report,  the 
names  used  as  inout  must  be  SETS,  INPUTS,  OUTPUTS,  ENTITIFS, 
GROUPS  and/or  PLFMF\’TS  ard  the  report  presents  *11  those 
PROCESS*?  which  manipulate  the  input  names  via  the  RECEIVED, 
USED,  up  DAT*  D , DEEIVFD  and  SENESATFD  statements  in  a particular 
Analyrer  data  base. 

Tf  the  PPOCFSS  parameter  is  used  in  qenerating  the  report,  the 
names  used  as  input  must  he  PROCESS  names  and  the  report 
presents  all  those  R FT , INPd’r,  OUTPUT,  ENTITY,  3ROUP  and  ELEMENT 
names  that  each  inout  PROCESS  name  manipulates  via  the  RECEIVES, 
USES , UPDATES,  ''EPIVFS  and  GENERATES  statements  in  a particular 
Anal  vr.er  data  base. 

"he  interactions  amonq  data  and  PROCESSES  are  shown  as  a matrix. 
An  analysis  on  this  matrix  presents  a summary  describing  the 
incomplete  aspect,  of  the  lanquaqe  description  with  respect  »o 
the  information  presented  in  the  matrix.  for  example,  a PROCESS 
producing  information  without  using  any  information  would  be 
identified  in  this  summary. 

A second  matrix  presents  th?  manner  in  which  the  PROCESSES 
(presented  in  the  first  matrix)  interact,  i.e.,  how  they  depend 
on  data  produce!  bv  other  PROCESSES.  Again,  the  information  in 
♦his  matrix  is  lerived  from  the  information  in  the  first  matrix. 

"inallv,  aa  analysis  is  performed  on  this  matrix  and  presented 
in  the  fora  of  a summary.  The  summary  identifies  those 
PROCESSES  with  no  predecessors  (i.e.,  do  not  USE  or  RECEIVE  data 
produced  by  other  PROCESSES!  and  those  with  no  successors  (i.e., 
do  not  DERIVE,  UPDATF  or  GFRERATE  any  data  used  by  other 
PROCFSSFS). 

’’’he  ♦wo  summaries  and  the  second  matrix  are  all  produced  based 
on  the  information  presented  in  the  first  matrix.  Therefore, 


■ 
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it“ms  which  aro  les  i a nat  «=»<i  incomplete  in  the  repart  way  actually 
hs  resolved  elsewhere  in  the  description  in  the  data  base.  For 
example,  if  the  following  description  was  in  the  data  base: 


op  oces  S; 
IISES: 
DERIVES: 


pa  y rol 1-or  ocessinq ; 
employee -information; 
oavsystem-outputs; 


and  the  DAT*  PP3CEFS  REPORT  was  produced  for  the  naie 
employee-information,  the  PROCESS  payroll-processing  would  be 
presented  since  i*-  USPS  i*.  The  report  would  then  identify 
oa vrol 1- nrocessi nq  as  USING  data  but  not  UPDATING  or  DERIVING 
anything  though  elsewhere  in  the  description  it  does.  For  this 
reason,  it  is  important  to  recoqniTe  that  the  comments  in  the 
report  are  made  with  respect  to  the  information  in  the  first 
matrix  rather  than  the  entire  description  as  it  exists  in  the 
data  base. 


^orm at 

■"wo  lists  of  names  are  first  presented,  one  labeled  ROW  NUNES 
and  the  other  COLUMN  NANFS.  If  the  DATA  parameter  was  used  in 
generating  the  report,  ♦he  names  designated  as  RDM  NAMES  are 
those  which  were  given  as  input.  If  the  PROCESS  parameter  was 
used  in  generating  the  reoort  the  names  designated  as  COLUMN 
N*Nps  are  those  which  were  given  as  input. 

In  anv  case,  each  name  under  COLUMN  NAMFS  in  some  way  (RECEIVES, 
USES , etc.)  interacts  with  zero  or  more  names  given  under  ROW 
NANFS  and  each  name  under  ROW  NAMES  is  manipulated  (USED, 
Pr,!Vpf',  etc.)  by  zero  or  more,  PROCESS  names  given  under  COLnNN 
FANES. 

The  DATA  PROCESS  INTERACTION  NATRTX  is  then  pcinted  out  to  show 
the  relationships  between  the  names  designated  as  ROW  NAMES 
(which  are  represented  by  the  rows  of  the  matrix)  and  the  names 
designated  as  COLUMN  NANFS  (which  are  represented  by  the  columns 
of  the  matrix).  The  rows  and  columns  of  the  matrix  are  numbered 
to  correspond  to  the  number  assigned  to  each  name  in  the  list  of 
ROW  NANFS  and  COLUMN  NANFS,  respectively. 

»n  °ntrv  (°,  u,  0,  A,  F,  1 or  2)  at  the  intersection  of  a 
particular  row  and  column  of  the  matrix  designates  that  the  name 
represented  by  the  row  is  manipulated  in  some  way  (as  defined  by 
♦he  meaning  of  the  entry)  by  the  name  represented  by  the  column. 
A legend  is  provided  as  part  of  the  report  that  defines  the 
meaning  of  each  possible  entry.  This  legend  is  shown  below  for 
purposes  of  clarification. 
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Row  i is  received  or  used  by  coljan  1 
(i npu  t) 

Pow  i is  updated  by  coluan  j 

Row  i is  derived  or  generated  by  coluan  1 

(output) 

Pow  i is  input  to,  updated  by,  and  output 
of  coluan  j (all) 

Pow  i is  input  to  and  output  of  coluan  1 
(flow) 

Pow  i is  input  to  and  updated  by  coluan  1 
Row  i is  updated  by  and  output  of  coluan 
1 


A summary  section  called  the  DATA  PROCESS  INTERACTION  MATRIX 
ANALYSIS  is  then  presented  specifying  those  inconsistencies 
found  in  analysis  of  the  DATA  PROCESS  INTERACTION  MATRIX. 
Inconsistencies  for  POW  NAMES  and  COLUMN  NAMES  are  handled 
separately.  Inconsistencies  found  for  ROW  NAMES  are  presented 
under  the  DA^A  heading  and  are  of  the  following  foraat: 


row  na«e 


(name-type)  (row  nuaber)  inconsistency  aessage 


Inconsistencies  found  for  COLUMN  NAMES  are  presented  under  the 
PROCESS  heading  and  are  of  the  following  format: 


column  naa» 


(row  nuaber)  inconsistency  «essage 


No  naae-type  is  necessary  because  all  names  under  COLUMN  NAMES 
are  PROCESSES. 

A second  matrix,  th?  PROCESS  INTERACTION  MATRIX,  is  printed  to 
show  relationships  implied  between  PROCESSES  in  the  DATA  PROCESS 
TV'E  ° ACT  TON  MATRIX.  In  this  matrix  both  the  rows  and  columns 
reoresent  ♦■hose  PROCESS  names  listed  under  COLUMN  NAMES  and  the 
rows  and  columns  are  numbered  to  correspond  to  the  appropriate 
name  in  COLUMN  n AMES . 

An  asterisk  (*)  entry  at  the  intersection  of  a particular  row 
and  coluan  of  the  matrix  designates  that,  the  PROCESS  represented 
by  ♦■he  row  DERIVES  or  UPDATES  some  inforaation  which  is  USED  by 
the  P°OC ESS  reoresented  by  the  coluan. 

A sumsarv  section  called  the  PROCESS  INTERACTION  MATRIX  ANALYSIS 
then  presents  observations  on  the  inforaation  in  the  PROCESS 
TNTE?ACTTON  MATRIX.  These  observations  are  presented  i.a  the 
following  format: 


process  name 


(row  -or  coluan  number) 


observation 


An  observation  is  given  for 
information  produced  by  any 
produce  information  used  by 


each  PROCESS  which  does  not  use 
of  the  other  PROCESSES,  or  does 
any  of  the  other  PROCESSES. 


not 
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■"he  report  mist  bo  jeneratel  using  either  tho  DATA  ar  PROCESS 
parameter.  It  tho  DATA  parameter  is  used,  all  names  given  as 
input  must  be  SET,  INPUT,  OUTPUT,  ENTITY,  OROUP  and/or  ELEMENT 
names.  If  the  PROCESS  parameter  is  used,  all  names  given  as 
input  must  be  PROCESS  names. 


Various  sections  ot  the  report  can  be  printed  or  left  out 
ieoendino  on  the  parameters  used  when  generating  it.  These 
parameters  and  their  effects  are  presented  below: 


1) 

ppm  *-» 

the  DATA  "POCESS  INTERACTION  MATRIX  is 
included  in  the  report 

NPDPMA  T 

- 

the  matrix  is  not  printed 

•>) 

DP  A NL 

- 

the  DATA  PROCESS  INTERACTION  MATRIX 
ANALYSIS  included  in  the  report 

VOD PAN L 

- 

the  analysis  is  not  printed 

3) 

eiA’" 

- 

'he  PROCESS  INTERACTION  MATRTX  is 
included  in  the  report 

NOPMAT 

- 

the  matrix  is  not.  printel 

PAN  L 

- 

the  PROCESS  INTERACTION  ANALYSIS  is 
included  in  the  report 

NOP  ANb 

- 

the  analysis  is  not  printed 

The  report  may  be  oenorated  for  a single  input  name  (via  the 
name  parameter)  or  for  a collection  ot  input  names  either 
sneclfied  by  the  user  or  retrieved  via  NANE-OFN. 


An  ai^s^s 

Each  name  given  as  input  is  searched  for  in  the  data  base.  If 
it  is  no'  found,  the  message: 

tt  R A 1 4 3 : M A T NPP  : NAME  NOT  IN  D.P.- 

is  printed.  If  the  name  Is  found  and  the  DATA  parameter  is 
used,  the  name  is  checked  that  it  is  a SET,  INPUT,  ENTITY,  (5R0IIP 
or  F LEME N"  name.  if  it  is  not,  the  message: 

tlRA1r>U:1AINDP:  INVALID  INPUT  NAME  TYPE 

is  printed  and  the  name  is  not  included  in  the  matrix. 
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T f the  DATA  parameter  is  used,  all  PROCESS  naaes  which  RECEIVE, 
USE,  UPDATE,  DFRIVF  and/or  GENERATE  each  input  naae  are  found. 
The  list  of  all  input  naaes  and  the  list  of  all  PROCESS  naaes 
found  are  then  printed  on  the  report. 

If  the  PROCESS  parameter  is  used,  all  SET,  INPUT,  OUTPUT, 

ENTITY,  GROUP  and/or  ELEMENT  naaes  which  interact  with  each 
inout  name  are  found.  The  list  of  all  input  naaes  and  the  list 
of  ail  SET,  INPUT,  OUTPUT,  ENTITY,  GROUP  and  ELEMENT  nates  founi 
are  then  printed  on  the  report. 

The  DATA  PPOCESS  INTERACTION  MATRIX  is  then  printed  with  the 
appropriate  value  (P,  u,  D,  A,  F,  1 or  2)  designating  a 
relationship  between  a column  name  and  row  name. 

The  matrix  is  then  analyzed  and  inconsistency  messages  are 
printed  as  data  diagnostics  (for  row  naaes  representing  SET, 
INPU*,  OUTPUT,  ENTITY,  GPOUP  and/or  ELEMFNT  naaes)  and  Process 
diagnostics  (for  coluan  names  representing  PROCESS  names). 

These  diagnostics  are  presented  below  categorized  by  th?  naae 
types  to  which  they  may  apply. 

T . 2i.ll  diagnostics  iROWSi. 

1)  INPUT  names 

- not  RECEIVED  fcv  any  PPOCESS 

If  no  PROCESS  names  RFCFIVE  the  INPUT  name  of  interest, 
this  diagnostic  is  printed.  If  at  least  one  PROCESS 
RECEIVES  the  INPUT  name,  the  message  is  not  printed. 

- not  USED  by  ary  PROCESS 

If  no  PROCESS  USES  the  INPUT  naae  of  interest,  this 
diagnostic  Is  printed..  If  at  least  one  PROCESSES  USES  tha 
INPUT  name,  the  message  is  not  printed. 

2)  OUTPUT  names 

- not  GENERATED  by  any  PROCESS 

If  no  PPOCESS  names  GENERATF  the  OUTPUT  naae  of  interest, 
this  diagnostic  is  printed.  If  at  least  one  PROCESS 
GEN F°AT  ES  the  OUTPUT  name,  the  message  is  not  printed. 

- not  n fnt v ED  by  any  PROCESS 

If  no  PPOCFSS  names  DFRIVE  the  OUTPUT  name  of  interest, 
this  diagnostic  is  printed.  If  at  least  one  PPOCESS 
nFPIVpS  tha  OUTPUT  name,  the  message  is  not  printed. 

1)  FNTITT  or  SET  names 
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- not-  DFPIVED  by  any  PROCESS 

Tf  no  PROCESS  names  DERIVE  the  ENTITY  or  SET  name  of 
interest,  this  diaqnostic  is  printed.  If  at  least  one 
TPPCESS  DFRIVFS  the  name,  the  message  is  not  printed. 

- DFRTVFD  but  not  OS  ED  by  any  PROCESS 

Tf  at  least  one  PROCESS  name  DERIVES  and  no  PROCESS  names 
OSF  the  ENTITY  or  SET  name  of  interest,  then  this 
diagnostic  is  printed.  There  are  3 conditions  that  mill 
cause  this  message  not  to  be  printed. 

i)  the  name  is  not  DERIVED  by  any  PROCESS. 

ii)  the  name  is  OSED  by  at  least  one  PROCESS. 

iii)  both  i and  ii. 

- UPDATFP  but  not  OSFD  by  any  PROCESS 

If  at  least  one  PROCESS  UPDATES  and  no  PROCESS  OSES  the 
ENTITY  or  SET  name  of  interest,  this  diagnostic  is  printed. 
There  are  3 conditions  that  will  cause  this  message  not  to 
be  printel: 

i)  the  name  is  not  UPDATED  by  any  PROCESS. 

ii)  th»  name  is  OSED  by  at  least  one  PROCESS. 

iii)  both  i and  ii. 

U)  GPP op  or  EMr N T 

- not  DERIVED,  UPDATED,  or  USED  by  any  PROCESS 

Tf  no  PROCESS  names  DERIVE,  UPDATE  or  USE  the  GROUP  or 
”LFMENT  name  of  interest,  this  diagnostic  is  printed. 

There  are  several  conditions  that  will  cause  this  message 
not  to  be  orint.ed: 

i)  at  least  on»  PROCESS  DERIVES  the  name. 

ii)  at  least  one  PROCESS  UPDATES  the  name. 

iii)  at  least  one  PROCESS  OSFS  the  name. 

i v)  all  3 or  any  combination  of  the  above. 

NOT”:  it  is  only  necessary  that  one  of  the  first  3 
conditions  is  satisfied  for  the  message  not  to  be  printed. 


1 


1 
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TT.  P£££ESS  DIAGNOSTICS  (COLUMNS) 

- does  not  interact  with  any  data 

If  the  PROCESS  of  interest  does  not  interact  with  any  SET, 

INPUT,  OUTPUT,  ENTITY,  GROUP  or  ELEMENT  naees,  this  diagnostic 
Is  printed.  If  at  least  one  name  interacts  with  this  PROCESS, 
this  message  is  not  printed. 

- us  Fs  data,  but  does  not  PFPIVE  or  UPDATE  anything 

If  t he  PROCESS  of  interest  USES  at  least  one  SET,  INPUT,  ENTITY, 
GROUP  or  ELEMENT  name  and  does  not  DERIVE  or  UPDATE  any,  this 
diagnositc  is  printed.  There  are  several  conditions  where  this 
sessaqe  will  not  he  printed: 

i)  the  PROCESS  doos  not  USE  any  SET,  INPUT,  ENTITY,  GROUP  or 
ELFHENT. 

ii)  the  PROCESS  DFRIVES  at  least  one  SET,  OUTPUT,  ENTITY,  GROUP 
or  ELENFNT. 

i ii)  the  PROCESS  UPDATES  at  least  one  SET,  ENTITY,  GROUP  or 
ELEMENT. 

iv)  all  3 or  anv  combination  of  the  above. 

- DERIVES  something  but.  does  not  USE  anything 

If  the  PROCESS  of  interest  DERIVES  at  least  one  SET,  ENTITY, 
GROUP  or  ELEMENT  and  does  not  USE  any,  this  diagnostic  is 
printed.  There  ar?  3 conditions  where  this  aessage  will  not  he 
printed: 

i)  the  PROCESS  doas  not  DERIVE  any  SET,  OUTPUT,  ENTITY,  GROUP 
or  ELEMENT. 

ii)  the  PROCESS  USES  at  least  one  SET,  INPUT,  ENTITY,  GROUP  or 
ELEMENT. 

iii)  both  i and  ii. 


- UPUHTFS  something  hut  does  not  USE  anythinq 

If  the  PPOCFSS  of  interest  UPDATES  at  least  one  SET,  ENTITY, 
GROUP  or  ELEMENT  and  does  not  USE  any,  this  diagnostic  is 
Drlnted.  Ther®  are  3 conditions  where  this  message  will  not  be 
printed: 

i)  the  PROCESS  doss  not  UPDATE  any  SET,  ENTITY,  GROUP  or 
ELEMENT. 

ii)  the  PROCESS  USES  at  least  one  SET,  INPUT,  ENTITY,  GROUP  or 
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FLEH*NT. 

iii)  both  i and  ii. 

■"he  PROCESS  I NTE RACT  TON  MATRIX  is  then  produced  using  the  data 
in  the  first  matrix.  The  entries  in  a given  column 
(representing  a PROCESS  name)  of  the  DATA  PROCESS  INI  ERA  CTION 
“ATRIX  are  compared  with  the  entries  for  each  other  column.  If 
an  entry  in  the  given  column  designates  that  the  PROCESS  USES 
information  which  is  DERIVED  or  UPDATED  by  the  column  being 
compared  with,  an  * entrv  is  made  in  the  PROCESS  INTERACTION 
matrix  at  the  column  or  row,  respectively,  representing  these 
two  PROCESS  name*?.  The  matrix  is  then  analyzed  and  observations 
are  produced  from  this  analysis.  These  observations  are 
presented  below. 

- no  interaction  with  other  PROCESSES 

If  a PROCESS  does  not  USF  an  object  and  also  does  not  DERIVE  or 
UPDATF  an  oblect,  this  diagnostic  is  printed.  There  are  3 
conditions  tha*  will  cause  this  message  not  to  be  printed: 

i)  the  PROCESS  USES  at  least  one  SET,  INPUT,  ENTITY,  3 ROUP  or 
ELEMENT. 

ii)  the  PROCESS  UPDATES  or  DERIVES  a SET,  OUTPUT,  ENTITY,  CROUP 
or  ELEHFNT. 

iii)  both  i and  ii. 

- no  predecessors  for  this  PROCESS 

If  the  PROCESS  o f interest  does  not  USE  any  objects  but  DERIVES 
or  UPDATES  at  lease  one  object,  this  diagnostic  is  printed.  The 
3 conditions  that  will  cause  this  message  not  to  be  printed  are: 

i)  the  PROCESS  USES  at  least  one  SET,  INPUT,  ENTITY,  GROUP  or 
ELFMENT. 

ii)  the  PPOCFSS  does  not  DERIVE  or  UPDATE  any  SETS,  OUTPUTS, 
ENTITIES,  CROUPS  or  ELEMENTS. 

iii)  both  i and  ii. 

- no  successors  for  this  PROCESS 

If  *-he  PROCESS  of  interest  USES  at  least  one  object  but  does  not 
DERIVE  or  UPDATE  any  object,  this  diagnostic  is  printed.  The  3 
conditions  that  will  cause  this  message  not  to  be  printed  are: 

i)  the  PROCESS  does  not  USE  any  SETS,  INPUTS,  ENTITIES,  GROUPS 
or  ELEMENTS. 

ii)  the  PROCESS  DFRIVES  or  UPDATFS  at  least  one  SET,  OJTPUT, 
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ENTITY,  GNU  UP  Dr  ELEMENT, 
lit)  both  i and  ii. 


Usage 

When  the  report  is  generated  using  the  DATA  parameter,  it  aids 
in  presenting  the  utilization  of  SET,  INPUT,  OUTPUT,  ENTITY, 
GPOrrp  and  ELEMENT  naaes  defined.  This  aids  in  identifying  which 
nanes  are  not  being  utilized.  For  those  naaes  which  are  being 
utilized,  it  presents  all  the  PROCESS  naaes  which  utilize  then. 

When  the  repor*  is  generate)  using  the  PROCESS  paraieter,  it 
presents  all  the  data  required  for  each  particular  PROCESS.  It 
also  aids  in  identifying  PROCESS  naaes  which  do  not  interact 
with  data  or  are  not  consistently  defined  with  respect  to  the 
Banner  in  which  they  use  data. 

The  PROCESS  INTERACTION  MATRIX  aay  be  used  by  designers  to  plan 
out  the  logic  of  the  target  systea  because  it  presents  the  data 
dependencies  aaong  the  PROCESSES  defined. 

The  following  coapleteness  checks  can  be  aade  for  a target 
systea  description  based  on  infornation  presented  In  the  report: 

- ALL  INPUTS  RECEIVED  by  sole  PROCESS 

- ALL  INPUTS  USED  by  soae  PROCESS 

- ALL  OUTPUTS  GENERATED  by  soae  PPOCESS 

- ALL  OUTPUTS  DERIVED  by  soae  PROCESS 

- ALL  ENTITIES  and  SETS  DERIVED  by  soae  PROCESS 


i 


h 


r 


P 


- ALI.  ENTITIES  and  SETS  DERIVED  and  USED  by  soae  PROCESS 

- ALL  ENTITIES  and  SETS  are  UPDATED  and  USED  by  soae  PROCESS 

- ALL  GROUPS  and  ELEE  ENTS  are  DERIVED  or  UPDATED  or  USED  by  soae 
PROCESS 

- ALL  PROCESSES  USE  data  and  DERIVE  or  UPDATE  data 

- ALL  PROCESSES  which  DERIVE  data  also  USE  data 

- ALL  PROCESSES  which  UPDATE  data  also  USE  data 

- ALL  PROCESSES  interact  with  data  in  soae  way 

The  report  lay  also  be  used  to  aid  in  deteraining  if  the 
description  of  the  target  systea  was  specified  consistently  with 
respect  to  the  use  of  language  stateaents.  in  particular,  it 
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determines: 

- whether  or  not  the  use  of  RECFIVES  and  GENERATES  statements 
in  describing  the  system  flow  aspect  of  the  systei  is 
consistent . 

- whether  or  not  the  use  of  USES,  UPDATES,  and  DERIVES  statement 
in  describing  the  data  derivation  aspect  of  the  systei  is 
consistent . 


Examples 

Fiqure  25  presents  the  DATA  PROCESS  REPORT  generated  for  all 
INPUT,  OUTPUT  and  ENTITY  naies  defined  for  a particular  target 
system  description.  This  example  was  produced  using  the 
Analyzer  commands: 

NAME-3FN  S='INPUT  OP  OUTPUT  OR  ENTITY' 
DATA-PPOCESS  DATA 

figure  2f  presents  the  report  generated  for  low  level  PROCESSES 
defined  in  the  description.  These  PROCESSES  were  identified  by 
the  KEYWORD  "terminal"  and  the  report  was  produced  by  the 
following  Analyzer  commands: 

NAM.E-3FN  S=  ' PROCESS  AND  KEY=termin  al ' 

DATA-PPOCESS  PROCFSS 
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Easesss 

This  report  presents  definitions  attached  to  naaes  used  in  a 
Language  description  and  is  intended  as  an  aid  in  commun ication 
among  persons  interested  in  the  description. 


Tnfppna t jon  Presented 

This  report  prints  out  the  following  information  about  each  name 
used  as  input  when  generating  the  report  and  the  appropriate 
parameters  are  used: 

- Name  type  of  the  name 

- DESCRIPTION  comment  entry  for  the  name 

- SYNONYM?  associated  with  the  name 

- RESPONSIBLE  PROBLEM  DEFINFF  for  the  name's  description 

- KEYWORDS  associated  with  the  name 

Ml  of  the  above  information  is  readily  available  from  the 
contents  of  the  data  base. 


Eaiaat 

a dictionary  entry  is  presented  for  each  name  given  as  input  to 
the  software  producing  the  report.  The  first  line  of  each  entry 
consists  of: 

- A number  designating  the  order  the  name  was  read  from  the 
in  out  (and  conseguently  presented  in  the  report) 

- The  name  the  entry  is  for 

- The  name  type  of  the  name 

*he  DESCRIPTION,  SYNONYM,  KEYWORDS  and 

RESPONSIBLE-PROBLEM-DEFINEH  statements  for  each  name  ars 
presented  in  the  following  format  after  the  first  line  of  the 
entry: 

DESCRIPTION: 

[DESCRIPTION  comment  entry] 

SYNONYMS:  [til  SYNONYMS  for  the  name  listed  two  per  line] 
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KEYWORDS : [all  KEYWORDS  for  the  name  listed  two  per  line] 

FESP  PD:  [PROBLEM  DEFINER  name] 

Spacinq  between  dictionary  entries  may  be  modified  by  the 
NUM- SPACE  PARAMETER. 


0 pti ons  and  Alternatives 

The  number  of  lines  skipped  between  dictionary  entries  is 
specified  by  the  NDM-SPACE  parameter.  By  default,  3 lines  are 
skinped  but  NUM-SPACE  may  take  any  value  C through  10. 

The  different  types  of  information  presented  in  a report  entry 
can  be  included  in  or  left  out  of  the  report  depending  on  the 
parameters  use*  when  generating  it.  Each  parameter  and  its 
effect  is  presented  below: 


DESCRIPTION 

the  DESCRIPTION  comment  entry  for 
each  name  is  printed 

NODESCRIPTION 

- 

DESCRIPTION  comment  entries  are  not 
pr inted 

K.  EYWORDS 

- 

all  KEYWORDS  associated  to  each 
name  is  printed  out 

NOKEYWOPDS 

- 

KEYWORDS  are  not  printed 

PESPONSTBT.3-PD 

- 

the  FESPONSI BLE- PROBLEM -DEF IN ER  for 
each  name  is  printed 

NORESPONSIBLF-PD 

- 

RESPONSIBLE-PROBLEH-DEFINERS  are 
not  printed 

SYNONYMS 

- 

all  SYNONYMS  associated  to  each 
name  are  printed  out 

NOSYNONYMS 

- 

SYNONYMS  are  not  printed 

An  INDEX  for  the  report  is  provided  when  the  INDEX  parameter  is 
used  , 


Anal y sis 

For  each  na»e  given  as  input,  the  software  finds  the  name  in  tha 
dava  base.  If  the  name  cannot  be  found,  the  message: 

URA064:  MAINDICT:  NAME  NOT  FOUND  IN  D.B.- 

is  printed.  Tf  the  name  is  found,  the  information  specified  by 
* he  parameters  for  the  command  is  retrieved  if  available  for  the 
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name. 


Usaje 

The  report  is  a valuable  aid  to  analysts  in  maintaining 
definitions  for  namps  in  the  data  base  and  as  a tool  for 
comm unicat.inq  with  users  of  the  target  systes.  The  DESZRIPTIONS 
for  each  nase  may  be  okayed  or  disapproved  by  the  users  with 
respect  to  what  the  users  require  of  the  target  systes.  As 
DESCRIPTIONS  are  modified,  the  analyst  can  add,  delete  or  aodify 
other  statements  *0  correspond  to  the  DESCRIPTIONS. 

If  conventions  are  imposed  on  the  lanquaqe  description  required 
for  particular  types  of  names,  an  effective  data  dictionary  can 
be  forned.  For  example,  by  requiring  certain  KEYWORDS  to  be 
assiqned  to  GROUP  and  ELEMENT  names  and  that  each  GROUP  and 
ELEMENT  name  have  a DESCRIPTION,  the  DICTIONARY  REPORT  would  be 
a good  reference  for  anyone  interested  in  the  data  described  in 
the  target  system. 


Examples 

Figure  27  presents  the  DICTIONARY  REPORT  for  a single  PROCESS 
name.  This  example  was  produced  by  the  command: 

DICTIONARY  NAN E*payrol 1- processing 

•igure  2R  presents  the  report  for  several  PROCESS  names  which 
have  the  KEYWORD  'independent'.  This  example  was  produced  by 
the  following  Analyzer  commands: 

N AME-GEN  S*'PPOCESS  AND  K EY*i ndependen t ' 

DICTIONARY 


120b 


a 

c 

Qi 

or  Ci' 

(N  QS 

I 

pa  >* 

Or.  C£ 


L 

Tt 

Oi 

C 

u y, 

to 

Q-  rH 

Li  U 

w 

ftl  •? 

0. 

P 

ft 

C -C 

y 

•rH 

o 

JZ 

rH 

r>  tj 

a. 

L'  10 

c 

ft 

a> 

•t1 

«i  t_j 

% 

r: 

f O 

0) 

ii 

a'  u-i 

e • 

cu 

ft 

4-' 

a 

c *. 

LI  Ll 

«e 

tz 

B P 

c. 

in  c 

n c. 

rn 

C B 

■O  O' 

i 

n n- 

ri  U 

n 

•H  L> 

C' 

-*->  i0 

c tr 

z 

f)  4J 

o c 

in  tfl 

• »H 

D 

li  *r 

Ci4 

01  y- 

in  C 

» 

r/j  io 

B O 

bJ 

o o 

Ll  Q-. 

i-J 

zz 

e tn 

m 

L>  (0 

'Ll  01 

M 

e u 

tn 

tn  a 

•rH  u 

Z 

fl  y 

O 

C 

u =• 

tn  u 

a 

O T5 

0) 

V) 

'Ll  c 

Ll  Iti 

r.j 

Li  Li 

o 

« 

O'  D. 

Ll  L> 

a. 

W 3 

to 

tr. 

o 

in 

0 

in 

r. 

tr. 

K Li 

44 

in 

in 

4-> 

in 

a 

b> 

« 

C 

64 

tn  tn 

c 

6-* 

c 

U 

ft  W 

c 

U 

0|  L> 

CD 

V 

at 

c 

O T?  • 

o? 

c 

o c 

*C 

c 

>- 

o; 

O Ll  1! 

c 

(X 

O -H 

c 

ou 

r»* 

CL 

P (0  ft 

a 

a 

P Ll 

<D 

a 

Q-U  ► 

a 

a cl 

a 

o 

tu 

a; 

m 

1/1  1)  H 

»r 

tn  a 

T* 

• • •<-!  B CL 

c 

••  -H  0) 

C 

>* 

se  sz  — e 

•r4 

z x:  -c 

•H 

z 

O f-‘  *j  0 

Cf-iu 

O 

M 

#• 

M 

• • 

c 

z 

O' 

r-> 

W 

Sh 

m 

*H 

►* 

c 

Cn 

p 

CL 

p 

in 

rn 

•^1 

M 

a 

LH 

cc 

in 

tr 

CL 

o 

rr 

a. 

o 

(1) 

W 

U 

at 

c 

L- 

a 

U 

r 

o> 

tr 

H 

»ii 

tr 

►< 

o 

h* 

a 

bt 

6-^ 

tn 

bi 

&u 

u 

§■ 

o 

c 

be 

tn 

e 

be 

Di 

a 

u 

0) 

1 

hi 

e 

0 

a 

o* 

• 

n 

Cl) 

U 

o> 

p 

► 

tn 

« 

CL 

0 

64 

►- 

* 

r*l 

C 

o 

01 

a 

*H 

0) 

• 

K 

O- 

y. 

4 

Pi 

■ 

0 

1 

r> 

a 

rH 

»r» 

z 

i 

a 

4 

M 

y. 

■ 

•i-4 

O 

r( 

n 

U 

z 

Li 

• 

B 

» 

6-’ 

O 

0' 

if- 

•J 

JZ 

e 

tr. 

H 

0 

r— 

(N 

r~ 

4 

r4 

•H 

C it 

u 

jS 

rtl 

S 4^ 

B— 1 

K-t  4 

IT  -C 

fA 

Oj  • jJ 

<1>  W 

U 

>-  4 e 

o 

O ~4  O 

Uj 

B<  »b4 

bU  Ll 

4- 

fl  fll 

c 

o:  a O' 

a> 

•c  c 

a 

1)  Ll  C 

a* 

(fl  rH 

4-> 

O B 

r n n 

44 

L Ll  c 

»n 

'Ll 

Li  tr 

•kL 

n » fl; 

ITI 

UJ  r|  O 

a 

rH  V. 

* o o 

o) 

IK  L rl 

Xi 

l>  y-  a. 

44  • 

IK  « B 

x: 

■O’  Q-  O' 

in  44 

o c 

tn  O'  rH 

u o 

t j=  rH 

a e 

L>  HJ  <0 

T1 

O' 

O i* 

h e l 

u 

ft  P o 

a a> 

•c 

c 

tr 

Ll  Ll 

w c 

4-’ 

tr 

it  oi  tn 

in  c 

c 

b 

(T.  C'-rH 

4 

4 

D 

f CH 

a w 

T? 

o 

V o 

O 4 

C 

a. 

0 i-o  <o  • 

u a' 

4 

a. 

U rH 

a >- 

a 

CL  c tn  rH 

o 

0) 

e li  P 

in »— i 

TJ 

tr  c li 

•»4  a 

C 

•’  >ri  o *H  y. 

?•  £ B 
Oh  01 


Z .x:  ^ u 

o t-  * a a 


H61RC/HU1  tics/URA  User's  Manual 


121 


Illimfi  EiEEflU  RJ5E2H 


Eaicass 

To  present  in  graphical  format,  for  each  name  input,  a network 
of  nanes  related  to  it  by  structure  or  by  data  flow. 


Information  Presented 

Names  innut  to  the  report  may  have  any  of  the  following  types: 

ELEMENT 
FNTITY 
OPO  up 
IVPTTT 
INTERFACE 
OUT  PUT 
PROCESS 
SET 

Startina  with  each  input  name,  one  of  four  pictures  will  be 
obtained.  These  are  referred  to  as  structure  downward, 
structure  upward,  data-flow  forward,  and  data-flow  backward. 

For  each  name  used  as  input,  the  report  presents  all  successors 
to  that  name,  whera  successors  are  found  using  the  relationships 
listpd  in  the  appropriate  column  of  either  Table  3 or  Table  4. 
For  each  of  these  new  names,  the  report  presents  all  of  its 
successors,  finding  them  in  a similar  manner.  This  network 
continues  until  the  desired  number  of  relationships  has  been 
traced,  a loop  is  encountered,  or  no  more  relationships  are 
f oun  d. 
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Naae  Type 

Relation  ships 
Displayed 

Structure  Downward 

Relationships 
Displayed 
structure  Upward 

ELEMENT 

CONTAINED 

ENTITY 

CONSISTS 

CONTAINED 

group 

CONST  STS 

CONTAINED 

INPUT 

StJBPA  RTS 

CONSISTS 

PART 

CONTAINED 

INTERFACE 

SUBPARTS 

PART 

OUTPUT 

SUB  PA  RTS 

CONSI STS 

PART 

CONTAINED 

PROCESS 

SUBPARTS 

UTILIZFS 

PART 

UTILIZED 

SE7* 

SUBSETS 

CONSI  STS 

SUBSET 

TABLE  3 

^rac^ure  Relationships 
Extended  Picture 


Displayed 

Report 


in 
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Vaee  Type 

Relation  ships 
Displayed 

Data-Flow  Forward 

Relationships 

Displayed 

Data-Flow  Backward 

FLEE  PN*r 

USED 

DERIVED 

USED  TO  DERIVE 

USED  TO  UPDATE 

UPDATED 

ENTITY 

USED 

DERIVED 

USED  TO  DERIVE 

UPDATED 

USED  TO  UPDATE 

GROUP 

USED 

DERIVED 

USED  TO  DERIVE 

USED  TO  UPDATE 

UPDATED 

INPUT 

PECEI VED 

USED 

USED  TO  DERIVE 

USED  TO  UPDATE 

GENERATED 

I NTE  PEACE 

GENERATES 

RECEIVES 

OUTPUT 

RECEIVED 

GENERATED 

DERIVED 

PROCESS 

GENERATED 

RECEIVES 

DERIVES 

USES 

UPDATES 

USES  TO  DERIVE 

USES  TO  UPDATE 

SET 

USED 

DERIVED 

USED  "'O  DERIVE 
nSED  TO  UPDATE 

UPDATED 

Table  4 

Data  Plow  Relationships  Displayed  in 
Extended  Picture  Report 
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Fora  at 

Each  name  which  appears  on  the  output  is  shown  within  a box. 

The  top  line  of  the  box  indicates  the  name  type,  while  the 
bottom  line  shows  the  relationship  with  a name's  predecessor. 
Poxes  containinq  related  names  are  linked  by  dotted  lines. 

If  a name  joins  two  or  more  chains  (strinqs  of  related  names) 
into  a loop  or  loops,  every  appearance  of  that  name  after  the 
first  will  be  linked  to  a box  containinq  the  message,  "LOOPS  TO 
PREVIOUS  ENTRY." 

Output  is  continued  across  page  boundaries.  If  t.he  right  edge 
of  one  page  continu°s  to  the  left  edge  of  a second,  the  right 
most  column  of  boxes  on  the  first  page  will  be  repeated  as  the 
l^ft  most  column  of  boxes  on  the  second  page,  in  order  to 
facilitate  matching  of  edges.  Similarly,  if  the  bottom  edge  of 
one  page  continues  to  the  top  edge  of  a second,  the  bottom  row 
of  boxes  on  the  first  paae  will  be  repeated  as  the  top  row  of 
boxes  on  the  second  page. 


Options  and  Alternatives 

"he  report  may  he  generated  for  a sinqle  name  (via  the  NAME 
parameter)  or  for  a collection  of  names,  either  input  by  the 
user  or  obtained  by  use  of  NANE-C.FN. 

The  type  of  picture  to  be  produced  is  selected  by  specifying  one 
of  the  following  parameter  pairs: 

STRUCTURE  DOWNWARD 
STRUCTURE  UPWAP  P 
DATA-FLOW  EOFWAPD 
DATA-FLOW  BACKWARD 

The  number  of  columns  and  rows  used  on  the  page  say  be  decreased 
from  their  default  values  of  11°  and  39,  respectively,  via  the 
COLUMNS  and  ROWS  oacameters.  The  minimum  acceptable  values  for 

■COLUMNS  and  POWS  are  38  and  14,  respectively. 

"he  number  of  boxes  arranged  horizontally  or  vertically  on  a 
page  may  be  decreased  from  the  defaults,  which  are  the  maximum 
numbers  that  will  fit  in  each  direction  (depending  on  COLUMNS 
and  nows) , in  order  to  make  the  output  less  cluttered.  The 
parameters  which  can  be  used  to  do  this  are  H0PIZ3NTAL-30XES  and 
VERTICAL-BOXES.  ^heir  maximum  values  (for  C0LUMNS=119  and 
°OWS  * 39)  are  6.  Due  to  the  scheme  for  continuing  pages,  their 
minimum  values  are  2. 

Th p number  of  connections  to  be  traced,  starting  at  the  given 
, name,  mav  be  set  ah  any  positive  value  via  the  LINKS  parameter. 

’’hi’  same  LINKS  value  is  used  for  all  names  input  when  the  FILE 
parameter  is  used. 


- 


‘ 


| 1 
r 1 

! i 
. ! 

I 

ij 

i 


; 


Part  in  URA  outputs 


H61BC/Nul tics/UPA  User's  Manual 


125 


t 


An  index,  containing  each  nine  used  on  the  report  and  the 
paqe(s)  on  which  it  appears,  lay  be  obtained  by  specifying  the 
INDEX  parameter. 


Anal y si s 

pach  name  given  as  input  is  first  checked  to  see  that  it  is  in 
the  data  base  and  'hat  it  has  one  of  the  legal  types  (ELEMENT, 
ENTITY,  CROUP,  INPUT,  INTERFACE,  OUTPUT,  PROCESS,  or  SET).  If 
the  name  is  not  in  the  data  base,  the  message: 

n R A 170 1 MAINEP:  NAME  NOT  pOUND  IN  DATA  BASE 

will  he  given.  If  the  name  has  a type  which  is  not  in  the  list 
above,  the  user  will  receive  the  message: 

nRA  301:  EP3UCC:  NAME  NOT  ACCEPTABLE  TYPE  FOR  EP  REPORT 

If  the  name  passes  these  two  tests,  it  is  placed  in  a data 
structure  which  will  later  be  used  for  output.  The  name  is  thei 
usel  to  generate  a tree  structure  as  follows.  Using  the 
relationships  in  the  appropriate  column  of  Table  1 or  Table  2, 
all  successors  for  the  name  are  retrieved  from  the  lata  base  and 
nlaced  on  a stack.  Then,  the  first  name  is  remove!  fro*  the 
stack,  placed  in  its  proper  location  in  the  data  structure,  and 
all  successors  for  that  name  are  retrieved  and  placed  on  the 
stack.  This  procedure  continues,  with  names  being  removed  from 
the  top  of  the  stack,  placed  in  the  data  structure,  and  used  to 
ohtain  further  names,  which  are  then  placed  on  the  stack.  At 
any  staqe  of  this  procedure,  no  names  will  be  put  on  the  stack 
if  one  of  the  following  is  true; 

1)  The  current  name  has  no  successors. 

7)  The  current  naie  has  been  encountered  earlier,  and  is 

therefore  at  the  end  of  a chain  or  forms  a loop  with  some 
portion  of  a chain  traced  earlier. 

i)  The  number  of  links  that  has  been  traced  on  the  current 
chain  is  egual  to  the  limit  set  by  the  LINKS  paramter. 

(For  every  input  name  for  which  this  occurs,  the  massage: 

UFA372:  EPSUrC:  LINK  LIMIT  SPECIFIED  MAS  PEACHED 


will  be  printed.) 

Thus,  in  any  of  these  cases  the  size  of  the  stack  will  decrease, 
’’’he  entire  procedure  is  complete  when,  after  any  search,  the 
stack  is  empty. 

The  data  structure  constructed  from  all  names  found  as  above  is 
broken  into  page-sized  units  and  is  printed  a page  at  a time. 


t 


i 

\ 

u 

' 

ft 

l 

f 


I 


Part  III  USA  outputs 


H61BC/Hultics/URA  User?s  Manual 


12S 


The  orocess  described  above  is  repeated  until  no  lore  names 
remain  in  the  input  stream. 


Usa  je 

The  EXTENDFD  PICTURE  is  very  similar  in  content  to  the  PICTURE 
r^oort  and  therefore,  aost  usages  of  the  PICTURE  report  apply  to 
the  EXTENDED  PICTUPF  report. 

In  addition,  tha  EXTENDED  PICTURE  report  providas  a 
comprehensive  view  of  the  information  flow  and  structure  aspects 
of  the  target  system  for  inclusion  in  the  final  specifications 
of  *he  svstea,  or  as  an  aid  in  coaaunicatinq  this  information  to 
others. 

Problem  definers  may  use  the  EXTENDED  PICTURE  report  to  visually 
analyse  the  description  of  particular  objects  and  the  system  as 
a whole,  for  completeness.  Table  5 presents  all  completeness 
checks  that  can  be  made  by  visually  scanning  EXTENDED  PICTDRE 
reports. 


Examnles 

Figure  2R  presents  an  EXTENDED  PICTURE  of  structure  information 
for  the  PROCESS  "hourly-employee-processing." 

Figure  3A  presents  and  EXTENDED  PICTURE  of  data  flow  information 
for  the  INTERFACE  "payroll-department."  The  amount  of 
information  presented  was  limited  by  setting  LINE=3. 
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structure: 


SET 

check  that  SET  is  broken  down  into 

ENTITIES,  or  INPUTS  or  SETS. 

IN  PUT /OU  TWIT/  - 
GROIIP/ENTITT 

check  that  these  are  eventually  broken 
down  into  ELEMENTS. 

GPOUP/EIEMENT  - 

check  that  these  are  contained  within  soae 
larger  data  structure. 

FLOW: 

Process  - check  that  inforaation  produced  is  used  in 

snae  Manner. 

- chech  that  inforaation  used  has  been  Bale 

available  (produced)  in  some  Banner. 

- check  that  all  PROCESSES  interact  with  lata 

in  sone  aanner. 


INTERFACE  - check  that  these  all  qenerate  INPUTS  to 

the  systea  and/or  receive  OUTPUTS. 

- ch*»ck  that  the  OUTPUTS  received  have  bean 

qenerated  in  sone  aanner. 

- check  that  the  INPUTS  generated  are  use!  in 

sone  aanner. 


SET  - chack  that  all  these  are  USED,  UPDATED  and/or 

DERIVED  in  soae  aanner. 


INPUT /OUTPnT / - check  that  all  these  are  produced  in  sote 
ENTITY  manner  and/or  used  in  soae  aanner. 


GPOU  P/FT.EMENT  - check  that  all  these  are  produced  in  soae 

manner  and/or  used  in  some  aanner. 


Table  5 

Completeness  Checks  that  may  be  made  by 
Visual  Analysis  of  the  EXTENDED  PICTURE  Report. 
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Purpose 

To  present  in  the  Lanquage  format,  all  description  gives  about 
one  or  more  panes  in  an  Analyzer  data  base. 


Inf ormat ion  presented 

The  report  presents,  for  each  name  used  as  input  when  generating 
the  report,  all  information  directly  available  in  the  data  base 
for  that,  name  and  its  relationships  with  other  names  in  the  data 
base.  Since  this  report  can  be  generated  for  any  type  of  name 
and  the  report  presents  all  Languaqe  relationships  specified  for 
each  name  type,  it  must  present  all  relationships  as  specified 
in  Part  II  of  the  UPL  User's  Manual. 


format 

All  information  presented  in  this  report  is  presented  as  legal 
Language  statements  and  is  formatted  according  to  the  values  of 
the  margin  parameters.  The  margin  parameters  have  the  following 
effects  on  the  format: 


A MARC. 

BNAPO  ■ 

CMAPC, 

HMAPT,  - 


NMAPO  - 


rvmaro  - 


indicates  the  column  at  which  the  first  name  of  a 
name  pair  is  to  be  outputted. 

indicates  the  column  at  which  the  second  nama  of  a 
name  pair  is  to  be  outputted. 

specifies  the  number  of  columns  between  SNAPS  and 
where  the  text  starts  for  a comment  entry. 

indicates  the  column  where  the  user  defined  name  in  a 
section  header  is  to  be  outputted. 

indicates  the  column  where  the  first  name  of  a name 
list  or  name  used  in  a Language  statement  is 
outputted . 

specifies  the  right  hand  margin  for  names  in  a name 

1 ist. 


SMABR  - indicates  the  column  in  which  the  Language  statement 
headers  will  be  started. 
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Pigure  31  illustrates  the  asrqin  paraeeters  with  respect  to  a 
part  of  an  actual  E3FHATTED  PROBLEM  STATEMENT. 


niAF< 


IPROCESS: 


(salar  ied-eaployee-processing; 


CMAPG 


| IDESC  RIPT  ION : 

i I [This  process  produces  the  pay  stateeent  for  salaried 


SMAPGft-H  SYNONYMS  APE:  Is-eap-proc, 

NMARG* >|s3  5 

I ATTRIBUTES  APE: 

A M A P G|^ >jcoBpl exit y-lewel  high  ; 


iployees  once  a nonth. 


BMAPGr 


Pigure  31 


All  Language  statements  presented  in  the 
segtienti  ally. 


PPS  are  nuiberad 


Tor  each  type  of  Language  section,  the  statenents  within  the 
section  are  ordered  as  giwen  in  Table  6.  Sections  in  the  EPS 
which  describe  undefined  nanes  or  relationships  not  allowed  by 
the  syntax  of  the  Language  are  presented  as  consent  statements, 
i.e.,  preceded  by  the  characters  /*  and  succeeded  by  the 
characters  ♦/. 
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CONDITION  section  SYNONYMS 

DESCRIPTION 
SEE-MEMO 
KEYWORDS 
ATTRI  BOTES 

BECOMING  TRUE  CAUSES 
BECOMING  MALSE  CAUSES 
BECOMING  TURE  INTERRUPTS 
BECOMING  FALSE  INTERRUPTS 
BECOMING  TRUE  TERMINATES 
BECOMING  FALSE  TERMINATES 
BECOMING  TRUE  TRIGGERS 
BECOMING  FALSE  TRIGGERS 
BECOMING  TRUE  IS  CALLED 
3FCOHING  FALSE  IS  CALLED 
MADE  TRUE  BY 
HADE  FALSE  BY 
TRUE  WHILE 
FALSE  WHILE 

RESPONSIBLE-PRDBLEM-DEFINER 

SECURITY 

SOURCE 

Table  6 

Ordering  for  FORMATTED  PROBLEM  STATEMENT 
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- 


DEFINE  section 


SYNONYMS 

DESCRIPTION 

3EE-MEM0 

KEYWORDS 

ATTRI BOTES 

APPLIES 

SOBSETTING-CRITBRION 

MAINTAINED 

/*  CONTAINED  */ 

/*  CONNBCTITITY  ♦/ 

/*  CARDINALITY  */ 

/*  HAPPENS  */ 

/*  VALUE  */ 

HE SPONSIBLE -PRD BL El- DEFINES 

SECURITY 

SOURCE 

Table  6 (continued) 


i 


t 


ts 

I 

i 


> 


t 
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ELF" *NT  section  SYNONYMS 

DESCRIPTION 

SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

CONTAINED 

SUBSETTING- CRITERION 

IDENTITIES 

ASSOCIATED  WITH 

VALUES 

USED 

UPDATED 

DERIVED 

CLASSIFICATION 

R E SPONSIBLE -PRO  BL  EH- DEE IN ER 

SECURITY 

SOURCE 

Table  6 (continued) 


I 
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ENTITY  section  SYNONYMS 

DESCRIPTION 

SBB-HBHO 

REWORDS 

ATTRIBUTES 

CONSISTS 

CONTAINED 

IDENTIFIES 

RELATED 

LAYO0T 

USED 

UPDATED 

DBRIYID 

CLASSIFICATION 

OCCURRENCES 

VOLATILITY 

RBSPONSIBLE-PROBLFN-DEFINER 

SECURITY 

SOURCE 

Table  f>  (continued) 
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EV*ST  section  SYNONYMS 

DESCRIPTION 

SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

HAPPENS 

ON  INCEPTION 

ON  TERMINATION 

CAUSES 

CAUSED 

INTERRUPTS 

TRIGGERS 

HAKES 

R ESPON  SIBLE -PROBLEM- DEE I NER 

SECURITY 

SOURCE 

Table  6 (continued) 
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GROUP  section  SYNONYMS 

DESCRIPTION 

SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

CONSISTS 

CONTAINED 

SOBSETTING- CRITERION 

IDENTIFIES 

ASSOCIATED- WITH 

USED 

UPDATED 

DERIVED 

CLASSIFICATION 

RESPONSIBLE-PROBLEM-DEFINER 

SBCnRITY 

SOURCE 

Table  6 (continued) 


f 
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INPUT  section  SYNONYMS 

DESCRIPTION 

SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

GENERATED 

RECEIVED 

SUBPARTS 

PART 

CONSISTS 

CONTAINED 

LAYOUT 

USED 

CLASSIFICATION 

HAPPENS 

CAUSES 

INTERRUPTS 

TERMINATES 

TRIGGERS 

MAKES 

RESPONSIBLE- PROBLEM  - DEFINER 

SECURITY 

SOURCE 

Table  6 (continued) 
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INTERFACE  section  SYNONYHS 

DESCRIPTION 

SEE-HERO 

KEYWORDS 

ATTRIBUTES 

GENER  ATES 

RECEIVES 

RESPONSIBLE 

SUB»ARTS 

PART 

S5CUFITY-ACCESS-R IGHTS 

RES&ONSIBLE-PRDBLER-DEFINER 

SECURITY 

SOURCE 

Table  6 (continued) 
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INTERVAL  section  SYNONYMS 

DBSCP IPTION 

SEE-EENO 

KEYWORDS 

ATTRIBUTES 

CONSISTS 

/*  CONTAINED  */ 

/*  HAPPENS  */ 

RE SPONSIBLE -PROBLEM- DEE I HER 

SECURITY 

SOURCE 


H61B0/Hultics/URA  User*s  Manual 


139 


MEMO  section  SYNONYMS 

DESCRIPTION 

KEYWORDS 

ATTRIBUTES 

APPLIES 

RE  SPO  RSI  BLE -PROBLEM- DEPINEB 

SECURITY 

SOURCE 

Table  6 (continued) 
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OUTPUT  section  SYNONYMS 

DESCRIPTION 
SEE-MEMO 
KEYWORDS 
ATTRI BATES 
GENERATED 
RECEIVED 
SO  BPARTS 
PART 

CONSISTS 

CONTAINED 

LAYOUT 

DERIVED 

CLASSIFICATION 

HAPPENS 

RESPONSIBLE-PROBLEM  - DEE  IN  ER 

SECORITY 

SOURCE 

Tahle  6 (continued) 
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PROBLEM- DEMIN MR  section  SYNONYM 

DESCRIPTION 

SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

MAILBOX 

RESPONSIBLE 

SECURITY 

SOURCE 

Table  6 (continued) 


'{ 

f 


-• 

i 

4 
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PROC  ESS  sect  ion 


SYNONYMS 

DESCRIPTION 

SEE-BEBO 

KEYWORDS 

ATTRIBUTES 

GENERATES 

RECEIVES 

SUBPARTS 

PART 

UTILIZES 

UTILIZED 

PEREORBED  BY 

RESOURCE-US  AGE 

USES 

UPDATES 

DERIVES 

PROCEDURE 

MAINTAINS 

SFCUPITY- ACCESS- RIGHTS 
HAPPENS 

INCEPTION-CAUSES 

TEPMINATION -CAUSES 

INTERRUPTS 

INTERRUPTED  BY 

TERMINATED 

TPIGGERS 

TRIGGERED 

MAKES 

R E SPONSIBLE -PRO BLEM-DEPINER 

SECURITY 

SOURCE 


T^ble  6 (continued) 
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PROCESSOR  section  SYNONYMS 

DESCRIPTION 

SEE-MEMO 

KEYWORDS 

ATTP1BUTES 

GENERATES 

RECEIVES 

SUBPARTS 

PART 

CONSUMES 

PERFORMS 

UTILIZES 

UTILIZED 

PERFORMED  BY 

RESOURCE-USAGE 

USES 

UPDATES 

DERIVES 

PROCEDURE 

MAINTAINS 

SECURITY- ACCESS -FIGHTS 
HAPPENS 

I NCEPTION-C AUSES 

TERMINATION -CAUSES 

INTERRUPTS 

INTERRUPTED  BY 

TERMINATED 

TRIGGERS 

TRIGGERED 

MAKES 

R E SPONSIBLE -PRO BLEB- DEE TNER 

SECURITY 

SOURCE 

Table  6 (continued) 
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RELATION  section  SYNONYMS 

DESCRIPTION 

SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

ASSOCIATED-DATA 

BETWEEN 

DERIVATION 

MAINTAINED 

CONNECTIVITY 

CARDINALITY 

R P SPONSIBLE -PROBLEM -DEE I NER 

SECURITY 

SOURCE 

Table  6 (continued) 


t 

r’ 


\ 
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RESOURCE  section  SYNONYMS 

DESCRIPTION 


SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

CONSUMED 

MEASURED 

BE SPONSIBLE -PROBLEM- DEFINER 

SECUPITY 

SOURCE 


Table  6 (continued) 
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E.SOnPCE-nSRGE-Pl^llNFTEP  section 

SYNONYMS 

DESCRIPTION 

SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

RESOURCE- US  AGE- P ARA N ETE R- YA  LOE 
COMPUTER- PROCESS  OR- CONS  ONES 
R ESPON  SI  BLR -PROBLEM  - DEFT  NER 
SECURITY 
SOURCE 

TjMp  ft  (continued) 
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This  stataaent  is  iqnored. 

DBSCRIPTIOH 

SE5-MBH0 

KMWORDS 

T»ACE  KM 

ATTRIBUTES 

ASSF»T 

RE SP OUST  BLE-TMTERFACF 

SnnSFTS 

SUBS  FT 

comsists 

SUBS  FTTT MG- CRITERIA 

nsso 

BERT  TED 

UPDATED 

PFRIFATTON 

CLASSIFTCATTOR 

OCCURRENCES 

VDLA  TILITY-H  EMRFR 

▼OLATILITY-S  BT 

BBS POM 51 BLF- PROP  LEM  - P EF INER 

SECURITY 

SOURCE 


Table 


(continued) 
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UNITS  section 


SYNONYM  S 

DESCRIPTION 

SEE-MEMO 

KEYWORDS 

TRACE  KEY 

ATTRIBUTES 

ASSERT 

MEASURES 

R E SPONSIBLE -PRO RL EM  - DEE IN ER 

SECURITY 

SOURCE 


Table  6 (continuel) 
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Aside  from  the  variations  in  the  report  format  as  the  result  of 
assignment  of  the  Margin  parameters,  there  are  a few  other 
parameters  which  modify  the  format  in  some  way.  These 
parameters  are  given  below  with  the  effect  they  have  on  the 
report  format. 


NEW-LINF 


NONEW-LINF 


specifies  that  the  first  name  in  a list 
of  names  for  Languaqe  statements  is 
started  on  the  line  following  tha 
statement  header. 

specifies  that  the  names  in  the  name  list 
beqin  on  the  sane  line  as  the  Laaquaqe 
statemen  t . 


For  example,  with  NEW-LINE  in  effect,  a Language  statement 
would  be  printed  as  follows: 

SYNONYMS  ARE  : 

s-enp-proc , 

s 3; 

With  NONEW-LINP  in  effect,  the  statements  are  printed  as 
fol lows: 

SYNONYMS  AFF  : 

s-emp-proc, 

p 1 • 

° J I 


NPW-PA 1 r 


NONFW-  PAOp 


- specifies  that  each  section  (description 
of  single  name)  presented  in  the  report 
would  be  printed  beginning  at  the  top  of 
a new  page. 

- specifies  that  sections  are  printed  one 
after  another. 


when  maintaining  an  up-to-date  copy  of  the  FPS,  it  is  often 
desirable  to  generate  the  FPS  for  all  names  in  the  data 
base  with  the  NEW- PAGE  option.  Any  modifications  to  the 
description  in  the  data  base  can  be  recorded  by  generating 
an  FPS  (with  the  NEW-PAGE  option  again)  for  those  nates 
affected  by  the  modification. 


ONE -t»FR- LINE 


specifies  that  the  names  in  a name  list 
within  a given  statement  be  pressnted  ona 
per  line. 


SEVERAL-  PEF-LT  NE 

- specifies  that  the  names  in  a naie  list 
be  presented  as  many  as  possible  on  a 
line. 
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^onr  information  in  the  EPS  can  be  included  or  left  out, 
depending  on  the  parameters  used  when  qeneratinq  it.  Bach 
parameter  and  Its  effect  is  qiwen  below. 


1)  COMMENT 


NOCOMMENT 


2)  DEFINE 


NODEFTNE 


1)  PESO 


NODESG 


specifies  that  comment  stateaents  for 
descriptions  of  undefined  naaes  and 
relationships  not  allowed  by  the 
Lanaguaqe  syntax  are  to  he  included  where 
applicable  in  the  report. 

specifies  that  the  coaaent  stateaents  are 
not  printed. 

specifies  that  descriptions  for  naaes 
which  are  described  by  a DEFINE  section 
(ATTRIBUTE,  ATTP I BUTE- VALUE,  KETNORD, 
MAILBOX,  SECURITY,  SOURCE,  SUBSETTING- 
CFITERION,  and  SYSTEM-PARAMETER  aaaes) 
are  included  in  the  report  when  these 
naaes  are  qiven  as  input. 

specifies  that  the  description  of  any 
name  described  by  a DEFINE  section  is  not 
presented  in  the  report 

specifies  that  the  descriptions  for  naaes 
which  are  SYNONYMS  for  other  names  in  the 
data  base  are  presented  in  the  report  by 
the  DESIGNATE  section. 

specifies  that  the  descriptions  for  names 
that  are  SYNONYMS  are  not  presented  in 
the  report. 


ALI-S^ATEMEMTS  (AS) 


specifies  that  all-statements  will 
printed  for  each  section  whether 
information  was  supplied  or  not. 


be 


NOALL-SFA"-EMFNTS  (NAS) 

- specifies  that,  only  those  statements  for 
which  there  is  information  contained  in 
the  data  base  will  be  printed. 

S)  LINE-MUMPERS  (LNS) 

- specifies  that  line  nuabers  are  to  be 
printed  on  the  left  side  of  the  report. 

NOLINE- NUMB  EPS ( NLNS) 

- specifies  that  line  nuabers  should  not 
appear  on  the  report. 

5)  PRINTEDF  (PEOF)  - specifies  that  an  extra  line  containing 
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EOF  is  to  be  produced  at  the  end  of  the 
output. 

7)  C!0  FPLEH  FNTA  R Y-ST  ATE  M ENTS  (COUP) 

- specifies  that  complementary  stateaents 
will  be  produced,  if  applicable,  in  each 
section  of  the  report. 

NOCOMPLEHENTAPY -STATEMENTS  ( (NCOMP) 

- specifies  that  no  complementary 
statements  will  be  output.  Thus  the 
number  of  stateaents  is  the  ainiiua 
necessary  to  describe  the  inforaation  in 
the  database  for  this  section. 

For  each  name  given  as  input  to  the  coaaand  producing  the 
report,  the  report  presents  the  appropriate  section  to  describe 
the  name.  For  example,  when  a PROCESS  name  is  given,  it  is 
described  in  a PROCESS  section.  Therefore,  when  a SYNONYM  name 
is  <given  as  input,  the  report  describes  the  SYNONYM  by  a 
DESIGNATE  section  rather  than  presenting  the  description  of  the 
name  the  SYNONYM  name  applies  to. 

An  INDEX  for  the  report  is  generated  when  the  INDEX  parameter  is 
used . 

The  report  may  be  generated  for  a single  input  name  (via  the 
NAME  parameter)  or  for  a collection  of  input  names  either 
specified  by  the  user  or  retrieved  via  NAME-GEN. 


Analysis 

For  each  name  qiven  as  input,  the  software  finds  the  name  in  the 
data  base.  If  the  name  cannot  be  found,  the  message: 

/*  NAME  NOT  FOUND  IN  D.B.-  */ 

is  printed  on  the  report.  Each  relationship  the  name  has  with 
other  names  is  printed  in  the  format  of  a legal  Lanaguage 
statement.  If  no  statement  exists,  the  relationship  is 
presented  as  a comment  entry.  Since  no  Language  section  is 
available  to  describe  an  UNDEFINED  name,  the  description  of  the 
name  and  relationships  it  has  with  other  names  are  presented  as 
a comment  statement. 


Usaje 

Since  the  PPS  oresents  all  the  description  given  about  each  name 
in  the  data  base,  the  report  is  beneficial  in  checking  the 
accuracy  of  each  description.  It.  is  usually  recommended  that  an 
PPS  for  all  names  be  maintained  as  a reference  and  updated  when 
changes  are  made  to  the  data  base. 
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Examples 

*igure  32  presents  an  FPS  for  a slnqle  name.  This  exaaple  was 
generated  by  the  followinq  command: 

FO  PM  AT’’’  ED-  PF3R  LEW-STATEMENT  NAME=payroll- processing 

Figure  33  presents  the  report  for  all  ENTITY  nates  defined  in  a 
particular  data  base.  This  example  was  generated  by  the 
following  commands: 

NAME-GEN  S='ENTITY' 

FPS 
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E2IB23S 

To  present  all  inforaation  based  on  the  use  of  the  HAPPENS 
stateaent  in  a particular  Analyser  data  base. 


Tnf oraat ion  Presented 

The  report  presents  si7e  and  voluae  inforaation  about  all  INPUT, 
OUTPUT,  PROCESS  an!  EVENT  naaes  defined  in  the  data  base  with 
respect  to  the  HAPPENS  stateaents  connected  to  those  types  of 
naaes.  An  entry  is  aade  in  the  report  for  each  INPUT,  OUTPUT, 
PROCESS  and  EVENT  with  a HAPPENS  stateaent  and  the  entries  are 
grouped  by  the  INTERVAL  over  which  the  HAPPENS  stateaent  is 
effective.  SYSTEH-PA FAHETERS  are  contained  in  each  entry  to 
define  the  number  of  tines  the  naae  associated  to  the  entry 
occurs  within  the  INTERVAL. 


f 21 111 


The  report,  presents  all  HAPPENS  stateaents  relative  to  a 
specific  INTERVAL  whose  naae  is  printed  on  a heading.  For  each 
INTEPVAI. , three  headings  are  printed  and  the  frequency 
information  pertaining  to  the  particular  INTERVAL  is  listed 
below  these  headings.  The  headings  are: 

NAME  - the  naaes  of  the  INPUTS,  OUTPUTS, 

PPOCESSES  and  EVENTS  which  HAPPEN  within 
the  designated  INTERVAL  are  listed. 

TYPE  - the  name  type  of  each  of  the  naits  given 

under  VAHE  is  listed. 


?I NFS  HAPPENS  - the  S Y STEM-PAP AN ETER  or  nuaber  used  in 

the  HAPPENS  stateaent  for  each  of  the 
naaes  qiven  under  NAME  is  listed. 

The  INTERVALS  are  presented  alphabetically  in  the  report.  No 
ordering  is  imposed  on  the  naaes  listed. 


2 cl 1222  and  iliatuiLiiss 

No  options  are  available  for  this  report. 


Anal ysjs 

The  data  base  is  searched  for  an  INTERVAL  naae  that  is  connectel 
to  a HAPPENS  relationship.  If  none  are  found,  the  aessage: 
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UFA286: FPINTV:  NO  FREQUENCY  INFORMATION  IN  DATA  BASE 

is  printed.  If  an  INTERVAL  name  is  found,  it  is  printed  out  and 
for  each  HAPPENS  statement  connected  to  it  the  naae  HAPPENS 
statement  applies  to,  its  name  type  and  associated 
SYSTEM-PARAMETER  are  retrieved  and  printed  out. 

The  search  for  another  INTERVAL  is  continued  until  all  names 
have  been  tested. 


Usaje 

The  report  is  helpfil  to  analysts  in  checking  that  all  items  in 
the  description  which  are  to  be  logically  related  via  their 
frequency  are  grouped  together. 

•’’he  report  is  also  beneficial  to  system  designers  when 
considering  the  relationships  of  various  parts  of  systea  with 
respect  to  frequency,  and  the  amount  of  input  and  output  to  be 
handled  by  the  target  system. 


Examples 

Figure  34  presents  the  FREQUENCY  REPORT  for  a Language 
description  of  a target  system. 
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iQEmim  mzu 

C11ID22S 

To  present  til  inforaation  based  on  the  use  of  IDENTIFIERS  for 
"NTITIES  in  a particular  Analyzer  data  base. 


!&£2£SlU2a  £l£sented 

If  IDENTIFIER  naaes  are  usei  as  input  when  generating  this 
report  (and  the  TDFMT IFIFR  paraseter  is  specified),  those 
Ft TT TIES  which  the  input  naaes  IDENTIFY  are  presented  la  the 
report. 

If  FNTT"Y  naaes  ar®  used  as  input  when  generating  the  report 
(and  the  ENTITY  paraaeter  is  specified),  those  IDENTIFIERS  which 
th®  input  naaes  are  IDENTIFIED  by  are  presented  in  the  report. 

Tn  either  case,  the  inforaation  is  presented  as  a aatriz.  An 
analysis  of  the  inforaation  in  the  aatriz  produces  soae 
statistics  show! no  the  nuaber  of  IDENTIFIERS  each  ENTITY  in  the 
aatriz  had  and  the  nuaber  of  ENTITIES  each  IDENTIFIER  identifies 
in  the  aatriz. 


?2£Si* 

If  the  IDENTIFIER  paraaeter  is  used  when  generating  the  report, 
anv  naaes  given  as  input  which  do  not  IDENTIFY  any  ENTITY  in  the 
data  base  are  flagged  at  the  beginning  of  the  report.  If  the 
PNTI TY  paraaeter  is  used  when  generating  the  report,  any  naaes 
given  as  input  which  are  not  IDENTIFIED  by  any  IDENTIFIER  in  the 
data  base  are  flaqged  at  the  beginning  of  the  report. 

f* 


"wo  lists  of  naaes  are  then  presented,  one  labeled  RON  NAMES  ani 
the  other  COLUMN  NAMES.  Tf  the  IDENTIFIER  paraaeter  was  used 
when  generating  the  report,  the  naaes  designated  as  RON  NAMES 
are  those  which  were  given  as  input.  If  the  ENTITY  paraaeter 
was  used  when  generating  the  report,  the  naaes  designated  as 
COLUMN  NAMFS  are  those  which  were  given  as  input. 

In  anv  case,  each  naae  under  RON  NAMES  IDENTIFIES  oie  or  aore 
naves  under  COLUMN  NAMES  and  each  naae  under  COLUMN  MANES  is 
IDEM "IFIFD  by  one  or  aore  naaes  under  RON  NAMES. 

* aatriz  is  then  printed  to  show  the  relationships  between  the 
na»®s  designated  as  ROW  NAMFS  (which  are  represented  by  the  rows 
of  the  aatriz)  and  the  naaes  designated  as  COLUMN  NAMES  (which 
are  represented  by  the  coluans  of  the  aatriz).  The  rows  and 
coluans  of  the  aatriz  are  nuabered  to  correspond  to  the  nuaber 
assigned  to  each  naae  in  the  list  of  RON  NAMES  and  C01USN  NAMES, 
respectiwely . 
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M asterisk  (*)  entry  at  the  intersection  of  a particular  row 
ini  column  of  the  Matrix  designates  that  the  naie  represented  by 
♦he  roe  IDENTIFIES  the  ENTITY  represented  by  the  coluan. 

Inspection  of  an  entire  row  reveals  all  ENTITIES  that  a 
particular  name  (represented  by  the  row)  IDENTIFIES.  Inspection 
of  an  entire  column  reveals  all  IDENTIFIERS  for  the  particular 
name  represented  by  the  column. 

A summary  section  is  also  included  in  the  report  presenting  for 
each  ROW  NAME: 

- "he  row  it  was  represented  by  in  the  matrix  (ROW). 

- T^s  name  t.yne  (TYPE). 

- "he  number  of  * entries  in  its  row  (or  the  nuiber  of 
ENTITIES  it  IDENTIFIES)  (COflNT)  . 

’’’he  summary  presents  for  each  COLUMN  NAME: 

- "he  column  it  was  represented  by  (COLUMN). 

- Its  name  type  (TYPE). 

- The  number  of  * ?ntries  in  its  column  (or  the  number  sf 
IDENTIFIERS  for  it)  (COUNT). 

The  summary  section  for  ROW  and  COLUMN  names  is  ordered  in 
decreasing  order  of  COUNT. 


options  and  Alternatives 

The  report  must  be  generated  using  either  the  IDENTIFIER  or 
ENTITY  parameter.  If  the  IDENTIFIER  parameter  is  used,  all 
names  given  as  input  must  he  IDENTIFIER  names.  If  the  ENTITY 
parameter  is  used,  all  names  given  as  input  must  be  ENTITY 
names. 

The  report  may  be  generated  for  a single  input  name  (via  the 
name  parameter)  or  for  a collection  of  input  names  either 
specified  by  the  user  or  retrieved  via  NAME-GEN. 


analysis 

For  each  name  given  as  input,  the  software  finds  the  name  in  the 
da*a  base.  If  the  name  is  not  found,  the  message: 

U»A0R9:IDENTR:  NAME  NOT  IN  D. B.  - or 

UR A052:inENTC:  NAME  NOT  IN  D. B.  - 
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is  printed  depending  on  whether  the  IDENTIFIER  or  ENT ITT 
parameter  was  specified  for  the  coaaand,  respectively. 

If  the  IDENTIFIER  parameter  is  used,  each  naae  given  as  input  is 
checked  that  it  IDBNTIFIPS  one  or  aore  ENTITIES.  If  it  does 
not,  the  naae  is  listed  under  the  aessage: 

UPMChjIDRNTR:  THE  FOLLOWIN'?  NAMES  DO  NOT  IDENTIFY  ANYTHING 

’’’he  *NTI TIES  that  are  IDENTIFIED  by  the  input  naaes  are  found, 
''ha  list  of  all  input  naaes  and  the  list  of  all  ENTITIES 
retrieved  is  then  printed. 

Tf  +he  ENTITY  paraaeter  is  used,  each  naae  given  as  input  is 
checked  that  it  is  IDENTIFIED  by  one  or  aore  IDENTIFIERS.  If  it 
does  not,  the  naae  is  listed  under  the  aessage: 

n»  A IDE:  I DENTC : THE  FOLLOWIN'?  NAMES  ARE  NOT  IDENTIFIED  BY 
ANYTHING 

The  IDENTIFIERS  for  the  ENTITIES  given  as  input  are  found.  The 
list  of  all  input  naaes  and  the  list  of  all  IDENTIFIERS 
retrieved  is  then  printed. 

A matrix  is  printed  out  to  illustrate  the  relationships  between 
the  naaes  in  the  two  lists  and  each  relationship  is  designated 
by  an  asterisk. 

A suaaarv  is  then  produced  by  countinq  the  number  of  asterisks 
appearing  in  each  row  and  column  of  the  aatrix. 


Usage 

"*h*»  report,  presents  information  that  aids  the  analyst  is 
checkinq  t.he  completeness  and  consistency  of  the  problei 
statement  bv: 

1)  - identifying  those  ENTITIES  which  do  not  have  IDENTIFIERS. 

This  can  he  accoaplishad  by  the  following  Analyzer 
coa  aands: 

NAHB-GFN  S*' ENTITY' 

ENTITY- 1 DENT! FI FR  ENTITY 

2)  - being  in  an  easy-to-ana lyxe  format  to  check  that  the 

IDENTIFIERS  defined  for  the  problem  stateaent  are  being 
used  properly.  For  example,  a typing  error  nay  result  in 
an  IDENTIFIER  being  used  in  the  wrong  context. 

■"he  report  aids  tha  systea  desiqner  by  presenting  those  ENTITIES 
with  the  saae  IDENTIFIERS  and  aids  in  determining  a consistent 
and  well-defined  identifier  coding  structure. 
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£5i5i>l£ 

Kijnre  is  presents  the  report  using  the  ENTITY  parameter.  The 
Analyser  cnaaanrts  used  to  qenerate  this  oxaapla  were: 

NMF-r,*N  S=  * ENTITY’ 

'NT TTY-IPENTIFIEP  ENTITY 
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BSI£  INCUS 


£«£B2SS 

To  present,  in  an  aasy  to  inspect  format,  logical  groupings  of 
panes  defined  in  a particular  Analyzer  data  base  with  raspect  to 
the  spelling  of  the  names. 


r| 


titj 


s 


Information  Presented 

The  report  presents,  for  all  those  naaes  used  as  input,  an 
alphabetical  listing  consisting  of  an  entry  for  each  naie  as  it 
appears  as  input  and  entries  for  each  permutation  of  the  naae 
(about  the  dashes).  For  example,  if  the  naae 
hourly-eaployee- fora  was  supplied  as  input,  there  would  be 
entries  for: 

employment- form  hourly 

for*  hourly-employment. 

hou  rly- employment- form 

in  the  report.  When  there  are  several  names  used  as  input  then 
all  naaes  with  the  word  "employ ment"  in  them  would  hate  entries 
group  together,  all  those  with  "fora"  would  be  grouped  together, 
etc. 


Format 

The  entries  i'n 't  he  report  artf  ordered  alphabetically  and 
numbered  seguent iall y . There  are  two  parts  of  each  entry,  the 
right  hand  side  of  the  entry  presents  that  part  of  the  user 
defined  name  that  has  been  stripoed  off  for  a permutation  of  the 
name  and  the  left  hand  side  of  the  entry  presents  the  remaining 
part  of  the  name.  The  distance  (the  number  of  columns)  between 
the  right  and  left  sides  of  the  entry  can  be  varied  by  the  value 
assigned  to  the  OIF  parameter. 


OBUojis  lM  Alternatives 

The  OIF  parameter  may  take  on  any  value  from  2 to  52. 


iaalisis 

Fach  naae  given  as  input  to  the  software  generating  the  report 
is  inspected,  separated  at  the  dashes  in  the  naae  and  a list  is 
formed  consisting  of  the  original  name  and  all  permutations  of 
the  name. 


After  all  naaes  in  the  input  list  have  been  processed,  the  newly 
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formed  list  is  sorted  and  presented  as  the  report. 


The  kwic  INDEX  Aids  analysts  in  maintaining  naae  conventions 
used  in  the  target  system  description  process  and  for  finding 
names  in  the  description  based  on  the  Keywords  within  the  naaes. 

It  is  often  desirable  to  use  soae  conventions  in  assigning  naaes 
to  objects  defined  in  a target  systea  description  and  the  KWIC 
TNDFX  aids  in  aaintaininq  these.  For  example,  by  issuing  the 
following  Analyzer  commands: 

NAME-RBN  S= 'ELEMENT' 

KWIC 

a K w TC  INDEX  is  presented  for  all  ELEMENT  naaes  so  that 
consistency  of  naming  can  be  checked. 


Exam  pies 

"igure  16  presents  a KWIC  INDEX  for  INPUT  naaes  defined  in  a 
problem  statement. 
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NAHE-OEN 


Purpose 

To  select  all  nines  from  the  data  base  with  respect  to  sole 
selection  criteria  (as  specified  by  parameters). 


Inf ocmat  ion  £resejjted 

The  report  presents  a list  of  names  and  their  cor respond  ing  nao 
types.  The  types  of  names  in  the  list  are  specified  by  the 
selection  criteria  used  with  the  SELECTION  parameter.  The 
selection  criteria  is  specified  by  using  logical  AND,  OR,  NOT 
operators  with  various  opennds  (including  all  name  types)  in  a 
boolean  expression.  For  example,  when  the  SELECTION  is 
TNTF°FACF  OR  PROCESS , the  report  presents  all  INTERFACE  and 
PPOCESF  names  in  the  lata  base.  When  the  SELECTION  is  PROCESS 
A n r>  KFYWORD=  leve  1-2,  the  report  presents  all  PROCESSES  In  the 
lata  base  that  have  the  KEYWORD  '•level-2"  associated  as  part  of 
their  description. 


format 

Inv  entry  in  the  report  is  printed  for  each  name  retrieved  and 
consists  of: 

- the  name  retrieved,  and 

- the  name  tyne  of  the  name 

The  entries  in  the  report  are  ordered  in  one  of  three  ways: 

1)  alphabetically  on  the  names  within  a name  type  (which  are 
also  ordered  alphabetically)  when  the  0PDER=BYTYPE 
parameter  is  in  effect. 

2)  alphabetically  on  the  names  when  the  0RDER=  ALPHA  parameter 
is  in  effect., 

1)  on  the  attribute  values  associated  with  specified  attribute 
names  when  user  attribute  names  are  specified.  The  output 
will  be  sorted  on  the  value  of  the  first  attribute  name, 
then  on  the  second  name,  etc.  Names  which  do  not  have  the 
specified  ATTRIBUTE  are  placed  at  the  beginning  of  the  list 
of  names. 

Ml  ORDER  options  except  ALPHA  may  be  used  in  any  combination  in 
the  list  of  parameters.  The  list  of  parameters  may  not  exceed 
five  options.  The  9YTYPF  option  may  appear  only  once.  The 
names  are  ordered  first  on  the  first  option  in  the  ordering 
list;  within  that  ordering  on  the  second  option  in  the  ordering 
list  , et c. 
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Opt 1 ons  and  Alternatives 

The  Selection  Criteria  paramater  permits  the  user  to  specify  the 
types  of  naees  to  be  retrieved  by  giving  a boolean  expression. 
Either  the  SELECTION  or  INPOT  parameter  eust  be  used  to  give  the 
boolean  expression.  If  SELECTION* • boolean  expression'  is 
specified,  the  boolean  expression  appears  inside  the  quotes 
following  the  equal  sign.  If  INPUT*fdname  is  used,  the  boolean 
expression  lust,  be  in  the  file  specified  by  the  user. 

The  naees  retrieve!  in  the  NAME  GPN  report  depend  on  the  itees 
or  operands  given  in  the  boolean  expression.  Each  of  these 
operands  represents  soee  qrouping  of  naees  which  nay  be 
contained  in  the  data  base.  An  explanation  of  each  of  these 
operands  is  given  below. 


The  following  name  types  nay  be  used  as  operands: 


ATTRIBUTE 

ATTRIBUTE- VALUE 

CLASSIFICATION 

CONDITION 

ELEMENT 

ENTITY 

EVENT 

GROUP 

INPUT 


INTERFACE 

INTERVAL 

KEYWORD 

MAILBOX 

MEMO 

OUTPUT 

PROBL  EM  - DEF  IN  EP 

PROCESS 

PROCESSOR 


RESOURCE 

RESOURCE-USAGE- PARAMETER 

SECURITY 

SET 

SOURCE 

SUBSETTIN3-CRITERION 

SYSTEM-PARAMETER 

UNDEFINED 

UNIT 


ALL 


When  the  ALt.  operand  is  specified,  the  names  of  all  name  types 
except  SYNONYM  and  UNDEFINED  will  be  presented. 

TOTAL 

When  the  TOTAL  operand  is  specified,  every  name  in  the  iata  bass 
will  be  presented. 


BASIC 

When  the  BASIC  operand  is  specified,  the  basic  names  will  be 
included  in  the  output.  The  **BasiC  names  are  those  names  whicn 
ar*  not  SYNONYMS. 


UNDEFINED 

When  the  UNDEFINED  operand  is  specified,  the  undefined  names 
will  be  presented. 
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ATTR=att.r-name*  , value] 

When  the  ATTR  operand  is  specifed,  those  naaes  with  the  given 
user-nane  as  an  ATTRIBUTE  ace  selected  to  be  pact  of  tha  output. 
The  user-naae  aust  be  a naae  defined  as  an  ATTRIBUTE  in  the  data 
base . 

T f an  ATTRI B UTE- V ALU E is  specified  as  pact  of  the  user  naae  then 
only  those  names  with  the  given  user-naae  as  an  ATTRIBUT E- VALUE, 
for  the  AT^R  T BUr  E designated  by  the  ATTR  parameter,  are  selected 
to  be  part  of  the  output.  The  user-naae  aust  be  an 
ATTRIBUTE-VALUE  name  in  the  data  base. 


SUSP  APTS -OF (SO) = user- nan e( .level  1 

»ll  naaes  which  belong  to  the  SUBPARTS  structure  for  a given 
naae  (as  would  be  retrieved  for  the  STRUCTURE  report)  can  be 
retrieved  hv  specifying: 

SUBPAPTS-OF=naae 

where  the  naae  is  an  INPUT,  OUTPUT,  PROCESS  or  INTERFACE  naae 
which  has  SUBPARTS  information  defined  for  it.  The  nuaber  of 
levels  to  go  down  and  retrieve  naaes  to  present  in  the  report  is 
specified  by  the  SUBLEVEL  parameter  or  by  attaching  a coaaa  and 
a level  nuaber  after  the  user-name  with  the  SUBPARTS-OF 
naraaeter.  If  SUBLFVEL*0,  then  all  levels  of  naaes  are 
presented.  If  SUBLEVEL*1,  then  onlv  those  naaes  which  ire  PART 
of  the  SUBPARTS  OF  name  are  presented.  The  following  picture 
may  clarify  th®  association  between  the  value  of  SUBLEVEL  and 
the  naa®s  presented. 

SUBPARTS-OF  naae 
SUBLEVEL* 1 
SUBLEVEL* 2 
SUBLEVEL*  3 


SUBLEVEL*0 


(Generation  of  the  report  with  SUBPARTS-0F=S1  and  SUBLEVBL*3 
would  present  S2 , S3,  S4,  S5 , S6,  S7,  SB,  S9 , S13  aad  Si  1 in  tha 
report.  Generation  of  the  report  with  SUBPARTS-3F*S 1 and 
SUBL F VEL * 1 would  present  the  naaes  S2,  S3  and  S4. 


SVNONTMS 


S 5 

/ \ 
SB  S9 

l\ 

!\ 

' \ 


S2 

I 

S6 


"V' 

S3 

s1, 

/ \ 

S10  S11 

/ 1 \ I 
/ I y I 
/ I ' ' 


S4 
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\ 
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•hen  the  SYNONYM  S operand  is  specified,  all  SYNONYMS  ata 
presented  for  each  naae  retrieved  in  the  report  in  addition  to 
the  basic  fora  of  the  naae.  If  only  the  SYNONYMS  are  desired, 
the  basic  naaes  aay  be  suppressed  by  specifying  the  NOBASIC  and 
SYNONYM  paraaeters.  With  standard  defaults  in  effect,  the  BASIC 
and  NOSYNONYH  paraaeters  are  used. 


KEY*user-naae 

when  the  key  operand  is  specified,  those  naaes  vith  the  given 
user-naae  as  a KEYWORD  are  selected  to  be  part  of  the  oatput. 
The  user-naae  aust  he  a naae  defined  as  a KEYWORD  in  tha  data 
base . 


PO*u  ser- naae 

When  the  PD  operand  is  specified,  those  naaes  with  the  given 
user-naae  as  a PROBL EH-DEFIN ER  are  selected  to  be  part  of  the 
output.  The  user-naae  tiust.  be  a naae  defined  as  a 
PROBLEM-  DEFT  NBR  in  the  data  base. 


son PCE=u ser -naae 

When  the  SonpcE  operand  is  specified,  those  naaes  vith  given 
user-naae  as  a SOURCE  vill  be  included  in  the  output.  The 
user-naae  aust  be  defined  as  a SOURCE  in  the  data  base. 


SECURITY *user-naae 

when  the  SECURITY  operand  is  specified,  those  naaes  vith  given 
user-naae  as  a SECURITY  vill  be  included.  The  user  naa>  aust  ba 
defined  as  SECURITY  naae  in  the  data  base. 


US AG  P*u ser- name 

When  the  usage  operand  is  specified,  those  naaes  vhich  have 
user-naae  as  IDENTIFIERS  in  the  data  base  are  selected  to  be 
narR  of  the  output.  The  syntax  of  the  Lanquage  only  allows 
ELEMENT,  GROUP  and  UNDEFINED  naaes  to  be  IDENTIFIERS. 

The  naaes  retieved  in  the  NAME  GEN  report  also  depend  oa  the 
operators  vhich  are  coahined  vith  the  operands  to  fora  the 
boolean  expression.  These  operators  further  define  grouping  of 
naaes  when  coahined  vith  operands.  An  explanation  of  each  of 
these  operators  is  given  belov. 


NOT,  - ,/ 
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The  NOT  operator  placed  before  an  operand  specified  that  the 
names  associated  with  that  operand  will  not  be  retrieved.  For 
example,  a boolean  expression  of  the  fore  NOT  PROCESS  mmans  that 
all  names  in  the  data  base  except  for  PROCESS  names  will  be 
retr ieved. 


and, k ,* 


The  AND  operator  specifies  that  any  name  retrieved  from  the  data 
base  must  meet  the  criterion  designated  before  and  after  the  AND 
operator.  For  example,  a boolean  expression  of  the  form  PROCESS 
AND  KEY=level-1  means  that  any  name  retrieved  must  be  a PROCESS 
name  as  well  as  have  the  KEYWORD  "level-1"  attached  to  it. 


DR,  | 

The  of  operator  specifics  that  any  name  retrieved  from  the  data 
has^  must  either  m»et.  the  criterion  designated  before  the  OR 
on^rator,  or  after  the  operator,  or  both.  For  example,  a 
boolean  expression  of  the  form  PROCESS  OR  KEY=level-1  means  that 
any  name  retrieved  must  be  either  a PROCESS  name,  or  have  the 
KEYWORD  "level-1",  or  he  both  a PROCESS  and  have  the  KEYWORD 
"level-1  ". 


iailxsis 

Each  name  definel  in  the  data  base  is  checked  against  the 
parameters  for  the  command.  If  it  satisfies  the  requirements  as 
specified  by  the  parameters,  it  is  placed  in  a list.  After  all 
names  in  the  data  base  have  been  checked,  the  list  is  sorted  as 
the  report. 

If  NAME-GEN  is  generated  for  an  empty  data  base,  the  message: 

PPAOUQ;  ENUM  RT : NO  NAMES  IN  DATA  BASE 
will  he  printed. 

If  there  are  no  names  in  the  data  base  which  satisfy  the 
selection  criteria,  the  message: 

URA523:  GFrNML:  NO  NAMES  WHICH  MATCH  CRITERION 

will  be  printed. 

If  the  selection  string  given  as  input  is  not  a Legal  boolean 
expression,  the  message: 

URA526:  N GPRS : INVALID  SELECTION  STRING 


Part  IIT  UR A Outputs 


H61RC /Hultics/URA  User's  Manual 


165 


will  be  priii tel. 

If  the  selection  string  given  as  input  contains  an  Illegal 
operand  or  operator,  the  eessage: 

URA52T:  NGPaS:  INVALID  item  in  selection  string 

will  be  printed. 

Tf  lore  than  five  ORDER  parameters  have  been  qiven  or  the  ORDER 
oaraeeters  have  been  given  incorrectly,  the  aessage: 

URAS29:  PPEPAR:  TOO  RANT  ORDER  PARAMETERS 

will  be  printed. 

If  the  name  qiven  in  the  orler  list  is  not  an  ATTRIBUTE,  the 
aessage: 


11RA52**:  PPEPAR:  NAME  IN  OPDER  LIST  NO  ATTRIBUTE 
will  be  printed. 

If  too  aany  levels  have  been  specified  via  the  SUBPARTS-OP  or 
SUBLEVEI.  parameters  (a  fifty  levels  is  aaxiaua)  , the  aessage: 

URAS15:  NGPPS:  TOO  RANT  LEVELS,  MAX  OP  50  ALLOWED 

will  be  printed. 


2232.2 

It  is  an  iaoortant  aid  to  the  analyst  in  obtaining  other  reports 
and  outputs.  For  exaaple,  the  analyst  can  ask  for  a list  of  all 
SET,  ENTITY  and  GROUP  names  and  with  this  list  then  ask  for  a 
CONTENTS  REPORT  for  these  names. 

It  is  also  used  by  the  analyst  as  a reference  to  what  nines  have 
been  used  and  how  they  have  been  used  (i.e. , what  their  naae 
t ypes  are) . 

The  output  can  also  be  used  effectively  by  project  aanageaent  to 
measure  productivity  of  the  project  members.  This  can  be  done 
by  retrieving  a li3t  of  all  names  in  the  data  base  defined  by  a 
particular  problem  definer  (analyst)  and  comparing  it  to 
previous  lists. 

Finally,  the  NAME  GEN  output  can  become  an  integral  part  of  the 
final  specifications  as  it  acts  as  a directory  in  specifying 
name  lists  corresponding  to  certain  selection  criteria  (a 
directory  of  all  data  elements  say  be  desired  before  a section 
which  deals  with  the  definition  of  each  element  in  detail). 


Part  nr  ura  outputs 


H61 AC /Mul tics/UR A User's  Manual 


167 


Examples 

Figure  37  presents  a NAME  GEN  report  produced  for  all  PROCESS 
names  which  have  "level-2"  defined  as  one  of  their  KEYWORDS. 

’’’he  command  used  to  generate  this  example  was: 

. 

NAME-GEN  S= ' KEY  = term ina 1 AND  PROCESS' 

Figure  ?8  presents  a NAME  GEN  report  produced  for  all  names 
which  are  not  PROCESSES  and  which  have  "level-2"  defined  as  one 
of  their  KEYWORDS.  The  command  used  to  generate  this  example 
was: 

NAME-GEN  S=' PROCESS  * NOT  KEY=terminal' 

"■iqure  3°  presents  a NAME  GEN  report  produced  for  all  names 
which  are  SUBPARTS  OF  security-control-input  and  which  have  the 
ATTRIBUTE  occurrences  with  the  ATTRIBUTE-VALUE  unscheduled.  Tha 
command  used  to  generate  this  example  was: 

name-GEN  S= ' ATTR=occurrenoe-t ype,  unscheduled 

Figure  40  presents  a NAME  GFN  report  produced  for  all  INPUT  and 
output  names  which  have  the  ATTRIBUTE  copies  or  arrival- type 
with  the  ATTRIBUTE-VALUEs  3 or  random.  The  command  used  to 
generate  this  example  was: 

NAME -GEN  S= • {tnpu?| OUTPUT} 6 { ATTR=copies, 3 1 arrival- type, random}  ’ 
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Purpose 

To  present  a list  of  all  names  defined  in  a particular  Analyzer 
data  base,  the  name  type  associated  with  the  naae  and  SYNONYMS 
defined  for  each  naae. 


Inforaat ion  Presented 

•"he  report  presents  every  naae  currently  defined  in  the  user's 
data  base,  the  naae  type  associated  with  each  naae  and  the 
SYNONYMS  associated  with  each  naae 


Mora  at 

An  entry  in  the  repart  is  printed  for  each  name  in  the  Analyzer 
data  base  and  consists  of: 

- the  naae, 

i 

- the  naae  type  of  the  name,  and 

- any  SYNONYMS  for  the  naae, 

which  are  listed  under  the  headings:  NAME,  TYPE,  and  SYNONYM, 
respectively . 

The  entries  within  the  report  are  ordered  in  one  of  two  ways: 
alphabetically  on  the  names  when  the  ORDER*ALPHA  parameter  is  in 
effect  and,  alphabetically  on  the  names  within  name  type  (which 
are  also  ordered  alphabetically)  when  the  ORDER«BYTYPB  parameter 
is  in  ef feet . 

1 1 

If  no  SYNONYMS  are  available  for  a particular  name  a dash  (-)  i3 
printed  under  the  SYNONYM  heading.  If  more  than  one  SYNONYM 
exists  for  a name,  they  are  listed  beneath  each  other. 


Options  and  Altec  natives 

No  options  other  than  the  OR  OB  R*  AL  Prt  A and  OR  DBF*  BYTY  PE  features 
are  available  for  this  report. 


! 


Aaaiisla 

Each  name  in  the  data  is  inspected  and  its  name  type  and  any 
SYNONYMS  for  the  name  are  retrieved.  After  this  information  has 
been  collected  for  all  names  in  the  data,  it  is  sorted  and 
presented  as  the  report. 
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"ho  report  is  intended  to  he  used  as  a directory  facility  by 
anyone  needing  a reference  includinq  all  naies  defined  in  the 
data  base. 


pk  aw  plos 

Fiqure  u 1 presents  the  NAME  LIST  report  generated  with  the 
oppf  R*BYTYPE  opt  ion. 
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Purpose 

Ths  PICTURE  report  oresents  flow  and  structure  inforaation  about 
the  problea  statement  in  a graphical  foraat.  The  PICTURE  report 
provides  the  user  with  a detailed  view  of  one  part  of  the  target 
svsteu  description  (i.e.,  if  presents  all  flow  and  structure 
relationships  a particular  naae  has  with  other  naaes)  . 


Inf ? rpatjon  presented 

The  PICTURE  report  can  be  produced  for  any  naaes  in  the  data 
base  of  the  following  naae  types: 

IN "EPF  ACE  SET  INPUT  OUTPUT 

ENTITY  GROUP  ELEMENT  PROCESS 

The  inforaation  presented  in  the  report  varies  depending  on 
which  naae  type  the  report  is  produced  for  and  the  paraaeters 
used  when  generating  the  report.  For  each  naae  type  tha  FLOW, 
STRUCTURE  and  DATA  paraaeters  present  different  types  of  url 
relationships  as  retrieved  froa  the  data  base.  Table  7 shows 
fhe  relationships  presented  for  each  naae  type. 


fora  at 

The  PICTURF  report  is  generated  in  a graphical  foraat.  The 
basic  teaplate  for  the  foraat  is  shown  in  Figure  42.  A given 
PICTURE  report  describes  a single  naaed  object. 
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Up  to  5* 
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Up  to  6* 

♦ - --  ------ - - ♦ 
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Up  to  6* 
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Up  to  5* 

4-- 

I 

I 

I 

♦ 


♦ 

I 

I 

I 

♦ 


♦ if  aoret  report  is 
continued  on  next 
page  (except  for 
PART  UP  relationship 
which  only  one  per 
PICTURE) . 


General  PICTURE  Format  and  Limits  per  Page 

Figure  4 2 

The  object  being  described  is  represented  by  a retangular  box 
printed  in  the  center  of  the  report  page.  All  named  objects 
related  to  the  centar  object  are  also  represented  by  rectangular 
boxes  but  are  arranged  around  the  perimeter  of  the  page.  The 
name  type  (PROCESS,  ELEMENT,  etc.)  of  the  represented  object  is 
printed  along  the  top  line  of  each  box.  The  relationship  of  an 
object  (represented  by  one  of  the  perimeter  boxes)  with  the 
center  object  is  printed  along  the  bottom  line  of  the  box.  For 
illustrative  Durposes,  lines  extend  from  each  box  to  the  center 
box. 


♦  GROUP ♦ PROCESS ♦ ELEMENT ♦ 

T IT  II  I 

I gr-z  I I pr-x  I I el-y  I 

I II  II  I 

♦  USES ♦ ♦ + ♦ DERIVES ♦ 


?h«  preceding  example  is  to  be  interpreted  as  follows: 
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PROCESS  pr-x  USES  GROUP  gr-z  and, 
PROCESS  pr-X  DERIVES  ELEMENT  el-y. 


Should  a PICTURE  of  particular  name  exceed  the  page  limitation 
as  given  in  Figure  42  the  PICTURE  will  be  continued  on 
succeeding  pages. 


The  format  of  the  relationships  presented  varies  depending  on 
the  name  tvpe  of  the  oblect  being  described  (lust  as  the  types 
of  r elat  ionshiDs  vary).  See  Figures  43-49  on  how  relationships 
are  formatted. 
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♦-- TSTP 

i r 

I I 

T I 

♦-PART  OP-4 


♦ -OUTPUT— ♦ 
I I 

I I 

r t 

♦-RECEIVES* 


♦--TNTP ♦ 

I I 

I I 

I T 

♦ -♦ 


♦ - - 1 M PtJ  T — ♦ 
I I 

I I 

r i 

♦GENERATES* 


T * I 

I T 

r i 

♦RESPONSIBLE* 


• 

♦-  - INTP ♦ 

T I 

I I 

I I 

♦-SOBPAPTS* 


INTERFACE  PICTURE 
Figure  43 
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♦-PROCESS — ♦ 
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♦-PROCESS- ♦ 
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♦ SET ♦ 
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I [ ENTITY  ] I 
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I I 

T T 

I I 
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♦-SSCA  IS ♦ 

♦CONSISTS  OF* 

SET  PICTURE 
Figure  U 4 

♦-SUBSET--* 

l l 

i | 
1 
1 

i 3 
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♦  SET- — ♦ 

I I 

I I 

I I 

♦ CONT  AINE  D* 


♦—INPUT—* 
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I I 
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♦-PART  OF-* 


♦ — INTF-- 
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♦ REV?RAT*T>* 


♦--INPUT — ♦ 

I I 

I I. 

1 I. 

♦ — ♦ 


♦-PROCESS--* 
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I I 
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r i 

♦ RECBI TEDB  T* 


GROUP 
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I I 
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♦ — INPUT- 
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♦-PROCESS-* 
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♦-SUBPART-* 


TNPtlT  PICUTRR 
Fiqure  N5 
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♦ SET ♦ 

♦-OUTPUT--* 

I I 

I 

I 

T I 

I 

I 

I I 

I 

I 

♦CONTAINED* 

• 

♦-PART 

• 

OE-  ♦ 

♦-PROCESS-* 

• 

• 

• 

• 

• 

• 

T I 

• 

I T. 

♦ - 

OUTPUT — ♦ 

♦ - - 

I NTE- 

♦ 

T I 

• 

I 

I 

I 

I 

♦ HEN  FRAMED* 

• 

I 

I 

I 

• 

I 

I 

I 

I 

♦ - PROCFSS-* 

• 

♦ - 

— 

♦ RECEr  VEDBY* 

T T 

• 

• 

T T. 

• 

• 

T I 

• 

• 

♦DFRIVFDPY* 

• 

• 

• 

• 

♦-ELEMENT-- 

♦ 

♦-OUTPUT-* 

T 

I 

I I 

T 

I 

I I 

I 

I 

I I 

♦ CO  N SI STSOE ♦ 

♦SUBPARTS* 

OUTPUT  PICTURE 
Fiqure  46 
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♦ ---SET-  — * 
I I 

T I 

T r 

♦CONTAINED* 


♦ -PROCESS-* 
I I 

I I 

I I 

♦UPDATEOBY ♦ 


♦-PROCESS-* 
T I 
T I. 
I I 
♦ DEPIYEDBY* 


♦-ENTITY — ♦ 
I I 

T I. 

I I 

♦ 


♦-PROCESS-* 
I I 
.1  I 
I I 
♦-USED  BY-* 


GROUP 

♦-ELEMENT--* 
I I 
T I 
I I 
♦IDENTIFIED* 


GROUP 

♦-ELEMENT--* 
I I 

I T 

I I 

♦ CONSISTSOF* 


ENTITY  PICTURE 
Figure  47 
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V 


INPUT 


♦ - 

-ENTITY—* 

♦ - 

— SET ♦ 

♦ 

-OUTPUT — ♦ 

♦-PROCESS-* 

♦-RELATION-* 

I 

I 

I 

I 

I 

ENTITY  I 

1 

I 

I I 

I 

I 

I 

I 

I 

GROUP  I 

I 

I 

i r 

I 

I 

I 

T 

I 

I 

I 

I 

I I 

♦ IDENTIFIES* 

♦ - 

SSCN  FOR* 

♦CONTAINED* 

♦UPDATEDBY* 

♦ASSOCIATED* 

| 

• 

• 

• 

• 

• 

• 

• • 

• 

• 

• 

• • • 

• 

• 

• • • 

• 

• 

• 

• 

r 

• 

• • 

• • 

• • 

GROUP 

♦-PROCESS- 

♦ 

♦-ELEMENT-* 

♦-PROCESS-*  ► 

I 

I 

I 

I 

I I 

I 

T.. 

• • 

• • • • T 

I.  . 

1 1 ? 

T 

I 

i 

I 

I I ' 

♦ PERI  VEDB  Y* 

♦ ---- 

--♦ 

♦-USED  BY-* 

GROUP 

♦ELEMENT--* 
I I 
I T 
I I 
♦-CONSISTS* 


CROUP/ELEMENT  PICTURE 
Figure  48 


♦Pertains 
tD  GROUP 
PICTURE 
only 


ti 
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♦ -PROCESS- 

♦ 

♦ - 

PROCESS-- 

♦ 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

♦ -PART  9*- 

♦ 

♦UTILIZEDB Y* 

♦ --I  NPU"'--* 

• 

• 

• 

• 

♦ OUT  PUT--*- 

I I 

• 

• 

I I 

I T. 

• 

• 

• 

I I 

T I 

• 

• 

I I 

♦RECIFVES-* 

• 

♦-PROCESS- ♦ 

• 

♦ GE  NE  RATES* 

• 

I 

I . 

SE* 

• 

I 

T 

SET 

TNPUT 

I 

I 

OUTPUT 

♦-^NTT^Y-* 

• 

♦ 

♦-ENTITY--* 

T GROUP  I 

• 

• 

• 

I GROUP  I 

T ELEMENTI 

• 

• 

• • 

• 

I ELEMENT  I 

I T 

• 

• • 

I I 

♦ --USES--*. 

• 

• 

• 

• 

♦-DERIYES-* 

• • 

• 

• 

• 

• 

• 

• 

SET 

ENTITY 

RELATION 

♦-PROCFSS-* 

♦ --GROUP  — ♦ 

♦ — SSCN 

♦ ♦-PROCESS-^ 

I I 

T ELEMENT  I 

I 

I I 

I 

T I 

I I 

I 

I I 

I 

r r 

T I 

I 

I I 

I 

♦SUBPAPTS-* 

♦-UPDATES-* 

♦MAINTAINS*  ♦ UTILIZES-* 

PROCESS  PICTURE 
Figure  49 
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Delians  in!  lliaiMtiiss 

The  user  has  the  option  of  displaying  any  combination  of  the 
three  types  of  relationships  (DATA,  FLOW  and  STRUCTURE)  on  the 
report.  See  Table  7 for  which  relationships  are  displayed  in 
each  of  these  categories  for  a particular  naae  type.  For 
example,  if  only  the  CONSISTS  and  CONTAINED  inforaation 
(STRUCTURE)  were  to  be  displayed  for  a particular  ENTITT  naae, 
DATA  and  FLOW  relationships  could  be  suppressed  via  the  NODATA 
an)  NOFLOW  parameters.  The  parameters  allowed  and  their  effect 
on  the  report  are  described  below: 

1)  DATA 

NODATA 


2)  FLOW 

NOFLOW 


3)  STRUCTURE 

NOFTRUCTUFE  - specifies  that  these  relationships  are  not 
i ncluded. 

An  INDEX  for  the  report  is  produced  when  the  INDEX  paraieter  is 
used  . 

■"he  report  mav  be  generated  for  a single  input  name  (win  the 
NAIF  parameter)  or  for  a collection  of  names  either  specified  by 
the  USER  or  retrieved  via  NAME-GEN. 


Analysis 

por  each  name  qiven  as  input  the  software  finds  the  name  in  the 
data  base.  If  the  name  is  not  found  the  message: 

URA066:  MAIN  PIC : NAME  NOT  IN  D.B.  - 

is  printed.  If  the  name  is  found  it  is  checked  if  it  is  of  a 
legal  name  type  for  which  a PICTURE  may  be  generated,  i. e.  , a 
S^T,  INPUT,  OUTPUT,  ENTITY,  GROUP,  ELEMENT,  PROCESS,  or 
TN?PRFAC E name.  If  it  is  not  one  of  these  naae  types  the 
message: 

UP  A0K7 : HA  I N PTC : PICTURE  NOT  AVAILABLE  FOR  - 


- specifies  that  data  type  relationships  be 
included  in  each  PICTURE. 

- specifies  that  these  relationships  are  not 
i ncl  uded. 

- specifies  that  flow  type  relationships  be 
included  in  each  PICTURE. 

- specifies  that  these  relationships  are  not 
i ncluded . 

- specifies  that  structure  type  relationships 
be  included  in  each  PICTURE. 


1 


i 


» 


1 


\ 


: I 

I j 

i 


is  printed.  If  the  name  is  of  a legal  name  type  it  is  then 
checked  if  any  of  the  relationships  that  can  be  presented  in  the 
PICTURE  for  that  naie  type  exist  for  the  particular  name.  If 
none  of  these  relationships  exist,  the  message: 
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URA289: PCLRBT;  HO  PICTURE  AVAILABLE  FOR 

is  printed.  otherwise,  those  relationships  available  for  the 
naae  are  presented  in  the  report. 


2§§aa 

Prolect  aanageaent  can  use  this  report  to  gain  a basic 
understanding  of  the  functions  of  the  target  systea  by  viewing 
PICTURES  of  high  level  target  systea  objects. 

PICTURES  provide  a good  Beans  of  coaaunication  aaong  people  in 
the  prolect  and  those  external  to  it.  A graphical  forait  is 
often  easier  to  interpret  than  a matrix,  narrative  text,  etc. 


Problem  Definers  nay  use  ths  PICTURE  report  to  visually  analyze 
the  description  of  particular  objects  to  check  for  coapleteness. 
'or  each  type  of  naae  (e.g.,  PROCESS  or  ELEMENT)  several  checks 
can  be  sade  depending  on  the  relationships  presented  in  the 
report.  Table  8 prasents  coapleteness  checks  that  can  be  Bade 
by  visually  scanning  PICTURE  reports. 


IXliPlSS 

figure  *0  presents  a PICTURE  for  an  INPUT  naae  "tine-card. " 

figure  si  presents  a PICTURE  for  an  INTERFACE  naae  "eaployee." 

"igure  52  presents  a PICTURE  for  a PROCESS  naae  "houtly- 
eaplovee-processing. " This  exanple  was  produced  by  giving  the 
following  Analyzer  coaaand: 


PICTURE  NAMS*hourly-enployee -processing 
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WANE  TYPE 

RELATIONSHIPS  DISPLAYED 

INTERFACE 

PLOW 

«■» 

RECEIVES 

GENERATES 

STRUCTURE 

• 

PART  OF 

SUBPARTS  APE 

DATA 

- 

RESPONSIBLE  FOR 

SET 

PLOW 

- 

DERIVED 

UPDATED 

USED 

STRUCTURE 

SUBSET  OP 

SUBSETS  ARE 

CONSISTS 

DATA 

RESPONSIBLE-INTERPACE 
SUBSETTTNG-CRITER IA 

THPTIT 

PLOW 

- 

GENERATED 

RECEIVED 

USED 

STRUCTURE 

PART  OP 

SUBPARTS  ARE 

CONTAINED 

CONSISTS 

OUTPUT 

PLOW 

- 

GENERATED 

DERIVED 

RECEIVED 

STRUCTURE 

PART  OF 

SUBPARTS  ARE 

CONTAINED 

CONSISTS 

ENTITY 

PLOW 

- 

DERIVED 

UPDATED 

USED 

STRUCTURE 

CONTAINED 

CONSISTS 

DA  "A 

IDENTIFIED 

li 


Table  7 

Nase  Types  and  Relationships  Presented  in  PICTURE  Report 
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NAME  TYPE 

RELATIONSHIPS  DISPLAYED 

GPOMP/FLEHENT 

FLOW 

- DERIVED 

UPDATED 

USED 

USED  TO  DERIVE 

USED  TO  UPDATE 

STRUCTURE 

- CONTAINED 

CONSISTS^ 

DATA 

- ASSOCIATED 

IDENTIFIED 

SUBSETTINS-CR ITER  ION 

PROCESS 

PLOW 

- RECEIVES 

USES 

USES  TO  DERIVE 

USES  TO  UPDATE 

DERIVES 

GENERATES 

UPDATES 

MAINTAINS 

STRUCTUR  E 

- PART  OF 

SUBPARTS  ARE 

UTILIZED  BY 

UTILIZES 

Table  7 (Continued) 


* This  relationship  only  applies  to  GROUPS,  i.e.  , an  ELEMENT 
cannot  CONSIST  of  anything. 
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IN^ERfACE 

An  INTERPACE  should  RECEIVE  an  OUTPUT,  GENERATE 
an  TNPUT  and/or  be  RESPONSIBLE  for  a SET. 

\\ 

* 

SET 

A SET  should  be  USED  by  a PROCESS,  DERIVED  by  a 
PROCESS,  and/or  be  UPDATED  by  a PROCESS. 

I 

■ 

A check  can  also  be  aade  that  the  SET  has  a 
RESPONSIRLE-INTFFACB. 

A 

£ 

If  the  SET  has  SUBSETS,  It  should  also  have 

SUR SETTING -CRITERIA. 

• 

l 

1 l 

INPUT 

An  INPUT  should  be  RECEIVED  by  a PROCESS  and 

GEN  ERATFD  by  an  INTERFACE.  An  INPUT  should 
also  be  DERIVED  by  a PROCESS. 

\ 

• j 

H 

OUTPUT 

An  OUTPUT  should  be  GENERATED  by  a PROCESS  and 

RFC FIVED  by  an  INTERFACE.  An  OUTPUT  should 
also  be  DERIVED  by  a PROCESS. 

; 1 

fi 

ENTITY 

An  ENTITY  should  be  USED  by  a PROCESS,  DERIVED 
by  a PROCESS,  and/or  be  UPDATED  by  a PROCESS. 

1 

A check  can  also  be  aade  that  the  ENTITY  Is 
IDENTIFIED  by  a GROUP  or  ELEMENT. 

GROUP/EL BURNT 

A GPOnp/ELEMENT  should  be  USED  by  a PROCESS, 
DERIVED  by  a PROCESS,  and/or  be  UPDATEO  by  a 
PPOCESS. 

n 

>3 
t 4 

r 

A check  can  be  aade  that  the  GR0UP/ELE1ENT  nay 
IDENTIFY  an  ENTITY,  be  SUB SETTING- CRITERION  for 
a SET  and/or  be  ASSOCIATED  with  a RELATION. 

i>  i 

j 

PROCESS 

A PROCESS  should  RECEIVE  an  INPUT,  GENERATE  an 
OUTPUT,  USE  a SET,  ENTITY,  INPUT,  GROUP  or 

ELEMENT,  DERIVE  a SET,  OUTPUT,  ENTITY,  GROUP  or 
ELEMENT,  npDATF  a SET,  ENTITY,  GROUP  or 

ELEMENT,  and/or  MAINTAIN  a RELATION 

r j 

! J 

s 

Table  8 

* 

Completeness  Checks  that  aay  be  aade 
by  the  PICTURE  Report. 

* 

ii 

< 
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piiiBfias 

To  present  in  a graphical  format  the  sequence  of  EVENTS  and 
PROCESSES  which  occurs  as  a result  of  each  EVENT  or  PROCESS 
specified  as  input. 


Tnf or*a»  jon  presented 

For  each  EVENT  name  given  as  input  to  the  software  producing  the 
report,  the  report  presents  all  PROCESS  names  which  the  EVENT 
'’'PTOGFPS.  Eor  each  of  these  PROCESS  names  prresented  the  report 
presents  all  EVENTS  occurring  ON-INCEPTION  or  ON -TERR I NATION  of 
the  ppoCESS,  The  raport  then  presents  all  the  PROCESSES  which 
theso  EVENTS  TRIGGPR,  etc.,  and  the  network  continues  until  a 
loop  is  encountered  or  no  more  relationships  are  found. 

For  each  PROCESS  name  given  as  input  to  the  software  producing 
the  report,  the  report  presents  all  EVENTS  occurring 
ON-TNCEPTIDN  or  ON- T E RM I N ATI  ON  of  the  PROCESS.  Por  each  of 
these  EVENT  names  presented  the  report  presents  all  PROCESS 
names  which  the  EVENT  TRIGGERS.  The  report  then  presents  all 
the  EVENTS  occurring  ON-INCEPTION  or  ON- TERN I NATION  of  the 
PROCESS,  etc.,  and  the  network  continues  until  a loop  is 
encountered  or  no  more  relationships  are  found. 


Format 

Each  name  which  appears  on  the  output  is  shown  within  a bo*. 

The  top  line  of  the  bo*  indicates  the  name  type  (EVENT  or 
PROCESS),  while  the  bottom  line  shows  the  relationship  with  the 
Drecreding  EVENT  or  PPOCESS  (TRIGGERED,  ON-INCEPTION, 

ON-T FRH TNATION) , Boxes  containing  related  names  are  liaked  by 
dotted  lines. 

If  a name  loins  two  or  more  chains  (strings  of  related  names) 
into  a looo  or  loops,  every  appearance  of  that  name  after  the 
first  will  be  linked  to  a box  containing  the  message,  "LOOPS  TO 
PREVIOUS  ENTRY." 

Output  is  continued  across  page  boundaries.  If  the  right  edge 
of  one  page  continues  to  the  left  edge  of  a second,  the  right 
most  column  of  boxes  on  the  first  page  will  be  repeated  as  the 
left  most  column  of  boxes  on  the  second  page,  in  order  to 
facilitate  matching  of  edges.  Similarly,  If  the  bottom  edge  of 
one  paqe  continues  to  the  top  edge  of  a second,  the  bottom  row 
of  boxes  on  the  first  page  will  be  repeated  as  the  top  cow  of 
boxes  on  the  second  page. 
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22*12112  mi  Alternat lies 

The  report  may  be  generated  for  a single  EVENT  or  PROCESS  naee 
(via  the  NAME  parameter)  or  for  a collection  of  such  naies, 
either  input  by  the  user  or  obtained  by  use  of  NAME-GEN. 

The  number  of  columns  and  rows  used  on  the  page  lay  be  decrease! 
from  their  default  values  of  11°  and  39,  respectively,  via  the 
COLUMNS  and  BOWS  parameters.  The  minimum  acceptable  values  for 
COLUMNS  and  rows  are  38  and  14,  respectively. 

The  number  of  boxes  arranged  horizontally  or  vertically  on  a 
page  nay  be  decreased  from  the  defaults,  which  are  the  maximum 
numbers  that  will  fit  in  each  direction  (depending  on  C3LTTMNS 
and  BOWS),  in  order  to  make  the  output  less  cluttered.  The 
narameters  which  can  be  used  to  do  this  are  HORIZONTAL-BOXES  and 
VERTICAL -BOXES.  Their  maximum  values  (for  C0LUMNS»119  and 
R3ws*39)  are  6.  Due  to  the  scheme  for  continuing  pages,  their 
minimum  values  are  2. 

The  number  of  connections  to  be  traced,  starting  at  the  given 
name,  nay  be  set  af  any  positive  value  via  the  LINKS  parameter, 
■’’he  same  LTNRS  value  is  used  for  all  names  input  when  the  FILE 
parameter  is  used. 

An  index,  containing  each  name  used  on  the  report  and  the 
page  (s)  on  which  it  appears,  may  be  obtained  by  specifying  the 
INDEX  parameter. 


iaalxsis 

Each  name  given  as  input  is  first  checked  to  see  that  it  is  in 
the  data  base  and  that  it  is  either  a PROCESS  or  EVENT  name.  If 
the  name  is  not  in  the  data  base,  the  message: 

UR A 380 : FILPAT:  NAME  NOT  IN  DATA  BASE 

will  be  given.  If  the  name  is  of  a type  other  than  PROCESS  or 
TVENT , the  user  will  receive  the  message: 

UR  A 381:  FILNAT:  NAME  NOT  EVENT  OR  PROCESS. 

If  the  name  passes  these  two  tests,  it  is  placed  in  a data 
structure  which  will  later  be  used  for  ouput.  The  name  is  then 
used  to  generate  a tree  structure  of  PROCESSES  and  EVENTS  as 
follows.  If  the  name  is  an  EVENT,  all  PROCESSES  which  it 
"RIGGERS  are  retrieved  from  the  data  base  and  placed  on  a stack. 
Then,  the  first  name  is  removed  from  the  stack,  placed  in  its 
proper  location  in  the  data  structure,  and  all  EVENTS  occurring 
DN-INCFPTIDW  or  ON-TERMINATION  of  that.  PROCESS  are  retrieved  and 
placed  on  the  stack.  This  procedure  continues,  with  names  being 
removed  from  the  top  of  the  stack,  placed  in  the  data  structure, 
and  used  to  obtain  further  names,  which  are  then  placed  on  the 
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stack.  At  any  stap  of  this  procedure,  no  naaes  will  be  put  on 
the  stack  if  on*  of  the  following  is  true: 

l)  The  current  name  is  an  EVENT  which  TRIGGERS  no  PROCESSES, 
or  a PPOCFSS  which  has  no  EVENTS  ocurrinq  3N-INCEPTI0N  or 
ON- "FPI I NAT  ION. 

21  The  current  naae  has  been  encountered  earlier,  and  is 

therefore  at  the  end  of  a chain  or  forms  a loop  with  soiae 
Dortion  of  a chain  traced  earlier. 

1)  The  number  of  links  that  has  been  traced  on  the  current 
chain  is  egual  to  the  limit  set  bv  the  LINKS  paraaater. 
(vor  every  input  name  for  which  this  occurs,  the  sassage: 

tlEAdbU:  '•IlMkT:  link  limit  specified  was  reached 

wil l be  printed . ) 

"Hus,  in  any  of  these  cases,  the  size  of  the  stack  will 
decrease.  The  entire  procedure  is  complete  when,  after  any 
SMrch,  the  Stack  is  emnty.  if  the  name  input  is  a PROCESS 
name,  the  first  search  is  for  EVENTS  occurring  3N-INCEPTI0N  or 
on-tfpmTNAtTON  of  that  PROCESS.  Proa  there,  the  procedure  is 
identical  to  that  described  above. 

The  data  structure  constructed  from  all  names  found  as  above  is 
broken  into  page-size  units  and  is  printed  a page  at  a time. 

The  process  described  above  is  repeated  until  no  more  names 
remain  in  the  input  stream. 


IlSiilS 

""he  PROCESS  CHAIN  report  presents  a comprehensive  view  of  the 
dynamic  behavior  of  the  PR02ESSES  within  the  target  system  for 
inclusion  in  the  final  sneci f ications  of  the  system  or  as  an  aid 
in  communion t ing  this  information  to  others. 

Programmers  and  System  Designers  in  particular  will  find  this 
report  helpful  in  identifying  and  optimizing  the  system  logic. 

Tf  the  PROCESSES  are  defined  to  the  level  of  computable 
statements,  the  PROEFSS  CHAIN  report  will  essentially  chart  out 
th«  program  logic. 

Problem  Definers  may  use  the  PPOCFSS  CHAIN  report  to  visually 
analyze  the  description  of  particular  objects  and  the  system  as 
i whole,  for  completeness.  Table  P presents  completeness  checks 
that  can  he  made  by  visually  scanning  PROCESS  CHAIN  reports. 


ZSiSUlS 
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PROCESS  The  absence  of  any  EVENT  as  a result  of 

INCEPTION  ar  TERMINATION  of  the  PROCESS  should 
be  rationalised. 


'VENT  The  absence  of  any  PROCESS  beinq  TRIGGERED  by 

an  FVFVT  should  be  rationalized. 


System  All  chains  should  terminate  in  one  of  three 

"'escrii)'  ion  w ays: 

1)  In  a loop  back  into  the  chain 

2)  Py  a PROCESS  desiqnatinq  the  last  activity 
in  the  procedure  represented  by  the  chain 

1)  Py  an  EVENT  desiqnatinq  termination  of  a 
procedure  represented  by  a chain 

Given  a particular  PROCESS  or  EVENT,  the  report 
allows  a trace  to  be  made  through  the  system  of 
actions  taken.  Checks  can  be  made  that  based 
on  a particular  starting  point  all 
EVENT-PROCESS  chains  evolving  from  the  starting  > 

point  terminate  correctly. 


Table  9 

Completeness  checks  that  may  be  made  by 
Visual  Analysis  of  the  PROCESS  CHAIN  Report 
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PROCESS  I N PUT/O UTPUT 


Purpose 

▼o  present  in  an  easy  to  examine  outline  fori,  the  basic 
functions  of  one  or  more  PROCESSES  in  the  Language  description 
and  how  these  PROCESSES  interact  with  information. 


Information  Presented 

The  report  presents,  for  the  PROCESS  names  given  as  input,  four 
types  of  information  which  may  be  printed  or  suppressed  by  the 
specification  of  appropriate  parameters  for  the  command 
generating  the  report. 

The  DESCRIPTION  parameter  permits  the  printing  of  the 
DESCRIPTION  comment  entry  for  each  PROCESS  if  available.  The 
PPOCEDUPE  parameter  permits  the  printing  of  the  PROCEDURE 
comment  entry  for  each  PROCESS  if  available. 

*h°  INPht  parameter  permits  the  printing  of  the  names  of  all 
SETS,  INPUTS,  ENTITIFS,  GROUPS  and/or  ELEMENTS  that  are  RECEIVED 
and/or  USED  by  each  PPOCFSS.  The  OUTPUT  parameter  permits  the 
printing  of  the  names  of  all  SETS,  OUTPUTS,  ENTITIES,  GROUPS 
and/or  ELEMENTS  that  GENERATED,  UPDATED  and/or  DERIVED  by  each 
PROCESS. 


format 

an  entry  in  the  report  is  printed  for  each  PROCESS  name  given  as 
input.  Each  name  is  identified  by  a number,  1*,  2*,  etc., 
designating  its  position  in  the  input  stream.  The  following 
format  is  used  to  print  out  information  about  each  process: 

• * process  name 

r DESCRIPTION  comment  entry] 


fPPOCEDURF  comment  entry] 

**+  INPUTS  *** 

[All  INPUTS  RFCEIVED  by  the  PROCESS] 

‘All  SETS,  INPUTS,  ENTITIES,  GROUPS  and  ELEMENTS  USED 
by  the  PROCESS  ] 

***  OUTPUTS  »•* 

[All  OUTPUTS  GENERATED  by  the  PROCESS] 
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[All  SETS,  OUTPUTS,  ENTITIES,  GROUPS  and  ELEMENTS 
DERIVED  by  the  PROCESS] 

[All  SETS,  ENTITIES,  GROUPS  and  ELEMENTS  UPDATED  by 
the  PROCESS] 

All  the  nates  listed  under  the  INPUTS  and  OUTPUTS  headings  are 
numbered  sequentially, 

tf  a DESCRIPTION  or  PROCEDURE  content  entry  is  not  available  for 
a particular  name,  that  part  of  the  format  is  not  included  in 
the  report.  If  no  names  are  listed  under  the  INPUTS  heading, 
the  messaqe: 

NO  INPUTS  POP  THIS  PROCESS 

will  be  printed.  if  no  nanas  are  listed  under  the  OUTPUTS 
heading,  the  message: 

NO  OUTPUTS  POP  THIS  PROCESS 

will  be  printed. 


Options  and  Alternatives 

Any  part  of  the  information  presented  for  each  PROCESS  name  can 
be  included  in  or  omitted  from  the  report  depending  on  the 
parameters  used  when  generated  it.  The  parameters  and  their 
effect,  on  the  report  are  given  below: 

1)  DESCRI PTTON  - specifies  that  t.he  DESCRIPTION  comment. 

entry  for  each  name  be  included  in  the 
re  po  r t . 

NODE SCR  I PTT  ON  - specifies  that  the  comment  entry  is  not 

print  el. 

7)  PROCEDUPE  - specifies  that  the  PROCEDURE  comment 

entry  for  each  name  be  included  Ln  the 

report . 

NOPROCEDUR11  - specifies  that  the  comment  entry  is  not 

printed  . 

1)  INPUT  - specifies  that  names  USED  or  RECEIVED  by 

the  PROCESS  are  presented  in  the  report. 

NOINPUT  - specifies  that  those  names  are  not 

printed . 

U)  OUTPUT  - specifies  that  names  DERIVED,  UPDATED  or 

GENERATED  by  the  PROCESS  are  presented  in 
the  report. 


H61  RC/Mul  tics/UPA  User's  Manual 


192 


NOOUTPUT  - specifies  that-  these  naees  are  lot 

printed. 

rach  entry  of  the  report  Is  started  at  the  beginning  of  a new 
paqe  when  the  NEW-PAGE  paraieter  is  specified.  tlhen  NONEW-PAGE 
is  in  effect,  the  entries  are  printed  one  after  another  in  the 
report. 

An  INDEX  far  the  report  is  produced  when  the  INDEX  paraaeter  is 
spec!  fied. 

The  report  nay  be  generated  for  a sinqle  naae  (via  the  NAME 
naraaeter)  or  for  a collection  of  naees  either  specified  by  the 
user  or  retrieved  via  NAME-SEN. 


Analysis 

'‘ach  name  given  as  input  to  the  software  producing  the  report  i3 
searched  for  in  the  data  base.  If  it  is  not  found  the  lessaqe: 

URA076:  M A INPFTO : NAME  NOT  IN  DATA  BASE  - 

is  printed.  If  it  is  found  a check  is  eade  that  it  is  a PROCESS 
naae.  If  it  is  not,  the  message: 

UR  A'IBB  • EAINPPIOt  NAME  NOT  A PROCESS  NAME  - 

is  printed.  If  the  naae  is  a PPOCESS  naae,  then  the  inforaatlon 
available  for  it,  as  requested  by  the  parameters,  is  presented 
on  the  report. 


iiaaas 

This  report  is  beneficial  in  presenting  a general  description  of 
the  functions  of  t.arqet  system  (as  described  by  the  PROCESS)  for 
purposes  of  coaaunica tions  between  analysts  and  users. 

It  may  also  be  used  by  analysts  to  chock  that  the  DESCRIPTION 
and  PROC  FDUP  E defined  for  each  PROCESS  is  in  agreement  with  the 
inforaatlon  which  is  input  t.o  or  output  from  the  PROCESS. 


ISafifilfiS 

•Igiire  su  presents  a PROCESS  INPUT/OTJTPUT  report  for  a a ingle 
name  "pa yrol 1-processing,  " 

"igure  55  presents  the  report  generated  for  the  SUBPARTS  of 
"oayroll-Drocessing. " This  was  done  by  the  following  cgaaands: 

NAME-GEN  S»'  S UBPA RTS-OE  = pa yrol 1- process! n g,  1 ' 


Part  lit  URA  Outputs 


H61 80/Multics/URA  User's  Manual 


PROCESS- INPUT-OUTPUT 


i 


PROCEDURE 


Part  III  UR A Outputs 


193a 


r-> 

c 

MT 

ft 


a 

u 


t- 

c. 

o 


r 


5> 

M 

« • 

ai 

ft 

IT 

• • 

s* 

cr 

ft 

r~ 

n 

»» 

ft-4 

ft 

*■> 

r 

»• 

rr 

r— 

Ci. 

c* 

% 

-O' 

C' 

ft 

•■* 

c 

fu 

«*■ 

r 

o 

X 

Ci » 

r 

r* 

n 

Ci 

in 

ft 

Cl- 

in 

r> 

*« 

t> 

a in 

o 

cu 

C5 

r 

v c 

w 

non 

r 

cr. 

Ci  tfl 

> 

«c  O'  ft) 

s» 

V 

ft 

U C/7 

M 

or.  > ft 

in 

t 

O 

a.  a> 

M C O 

ft:  ft  -C 

I 

sr 

c 

u u u 

SB  ft.  O 

ft: 

c. 

-H  O 

WWW 

ft:  ft)  ft 

ft. 

5r 

ft 

It)  u 

C fc  B 

C Q 3 

rr 

M 

C 

> o. 

15 

ft 

a; 

M 

ft 

f- 

T? 

Cl. 

CO 

Q 

c • 

# 

UJ 

M 

v <e  tn 

ft 

* 

u 

ft 

(0  *. 

ft 

« 

c 

u 

4)  to  3 

ft 

ft 

ft 

x=  *J  O. 

ft 

M 

cr  Dux. 

V) 

O 

a’  s 

to 

c 

f-> 

c 

X o o 

H 

o 

a 

0 

ft 

«) 

S3 

.H 

a 

•^4 

tr 

4'  *0 

ft 

fc< 

ft 

xs  .H 

ft 

w 

& 

ns 

h 

•a  4-  (0 

ft 

a 

c 

a 

s* 

•w 

ecu 

u 

o 

to  to 

O o 0 

o 

+j  4! 

ft 

•H  •*.  4. 

* 

4j 

F • 

C • u 

ft 

*>  a1  B 

• 

to  to  C 

O f*  3 

ft 

in  m .h 

« 

x.'  *- 

ft 

in  ti>  tj 

a a ■ 

a 3 • 

ft. 

a'  *-'  o 

U tx  u 

a o.  l. 

r- 

M 

u tn  u 

O O {1 

4J  4 

ft 

a.  a-  a 

WIW*1 

a b 4J 

ft* 

cr 

r- 

4 to 

B c to 

o e tn 

• 

r 

e 

U TJ 

.»H  *H  IQ 

1 • IT 

r 

»H 

•H 

*J  c 

t i a 

a a a 

1/) 

to 

in  a.  m 

to  a • 

a 4>  i 

ar 

n 

V) 

in 

tn  cr  „ 

0 tIH 

*1  *.  H 

O 

M 

a' 

« 

4 u tfl 

a-  a-.-. 

tfl  tfl  —t 

M 

ft 

u 

fi 

U « *. 

O O 0 

a-  a.  o 

ft. 

ft 

o 

0 

0*1  0 

l-t  14 

10  10  M 

OS* 

M 

u 

u a 

a.  a,  a. 

a.  a-  a. 

Ik} 

•• 

CL* 

o. 

a « a 

a a m 

Off 

► 

a, 

f 

1 

x:  •* 

4 4.  a. 

4 4a 

o 

iH 

*■* 

to  *> 

«r 

a. 

•H 

.**  M 

*-  (M  ir 

r-  in  m 

ft 

0 

o 

J9  C H 

V) 

14 

u 

a*  .«4  m 

a 

► 

►. 

a. 

(Q 

* 

I- 

a. 

a 

ft: 

»i 

St 

ft* 

<C 

K 

• 

ft. 

< 

*~ 

«r 

» 

Cu 

i 


PROCESS  INPnT/OHTpM? 


iUdlUC/iud  t«  I SbiJCdd 


nr. 

a 

CL 

T3 

1 

in  rn 

4 P 

.c  >n 

(N 

i 

1 

o «■ 

1 

4 in  4 

•H  4J 

O 4 

• 

t' 

4’ 

u 

1 

e 4 x 

u u 

► Jtf 

o 

4 

cl  a 

1 

•H  m r 

(0  ir 

4 U 

► . 

ti 

1 

4-4  m 

6-4  O 

O.  O 

y 

O 

e 

in  a 

1 

O'  *> 

if  4 

31 

o 

ST. 

in  o 

1 

T?  4J 

in  t 

4 

M 

CL 

4 

1 

4 U 

in 

in 

■ 

y in 

• 

4 4 

<D  U 

er 

4> 

0 4 

1 

u a u 

4-'  4-> 

U4  3 

61 

1 

U 4 

1 

<e  a. 

ID  <0 

4 O 

> 

■o 

a,  ► 

1 

r-l  ■ £ 

Tl  T 

C £ 

4 

o 

1 

(DOS 

a.  CL  4 

-r 

•H 

in  -4 

1 

in  u in 

3 3 

tr>  •• 

a 

U 

•H  to 

• 

4 

er 

r 

X!  « 

1 

• • • 

• • 

• 

rJ 

f->  4 

1 

r-  04  P"1 

r*  tr 

VT  O 

4-  T* 

0:  Li  • 
C O V 

u -* 

e U tr 
<e  c 


c ■ r\  c~ 

61  61  hi 

H l C C.  O 

< rf  <(  M (•'  W 

k a,  c.  > > ► 

ft’  61  hi  M M M 

a-  a-  ar.  c . a.  a, 
61  61  61  61  61  M 
» LI  L>  C fl  D 


*■’  C T* 
£ O U 


O 'H  O 

o 

« 

4J  u 

& 

« 

« 

O U u 

« 

« 

+ « IT 

a» 

# 

C 

U 

X3 

o 

• O C 

•H 

in 

> Kiu  O 

o 

to 

4 -> 

H 

( OC'rt 

L' 

f 

K3 

P 

CL  .H  L> 

■ 

to 

• in  « 

»r 

a* 

u 

e- 

u 

u 

► « » 4 * 

0 

8P 

0 

c- 

0 

o 

4 in  O 4 u 

e 

M 

4-i 

c 

a 

to 

o o U ►.  C 

C 

<D 

4 

Ij  CT  O <*-i 

w 

•H 

u 

U 

in  t-  .-i  a 

w 

« 

1 

« 

1 

• 

in  r a .h 

(T 

# 

* 

a 

4 

Cr.ee 

« 

• 

a' 

4 

L-  O U <1.  4J 

.V 

to 

► 

6- 

C"  u *w  c 

u 

• p4 

o 

o 

o 

*J  ♦ tTl-4 

C C O r C CL 
a<  -ri  ■ « m-i  « 


m v 4 
Qi  in  i 

*J  .»*  T1 
<«  .-I  4' 
£ I *H 
R 6 U 
I O <0 


fl  u « 

to  o>  in 


« 4J  4’ 

ai  in  i 

*J  .rl  T 
If*  fll 

V I -H 

in  m u 
i o a 

► 6H 

mum 
o.  o»  tn 


r-  N f"  S in  VC 


This  process  deletes  data,  for  those  employees  who 
are  no  longer  on  the  payroll,  fro«  the  files.  It  also 
orints  a list  of  all  employees  no  longer  on  tne 
payroll. 
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£iUJ£B£S  COMMENT  ENTRIES 


Purpose 

To  present  selected  comment  entries  given  for  one  or  aore  naaes 
in  a particular  flats  base. 

Tnf o cmat ion  Presented 

"^he  report  presents,  for  those  naaes  given  as  input,  any  coaaent 
»ntries  which  are  specified  as  paraaeters  and  ace  available  for 
the  naaes.  The  types  of  coaaent  entries  available  for  each  naae 
are  dependent  on  the  naae  type  of  the  naae  the  report  is  being 
generated  for.  The  table  below  shows  the  types  of ;coaaent 
entries  that  way  be  presented  and  the  types  of  naaes  thay  may  ba 
presented  for. 


Comment  Entry  Type  Name  Type 


DESCRIPTION 
PROCEDURE 
V01  ATI  L TTY 
VOIATILI^Y-MPMB  ER 
VOLATILITY-SET 
DERIVATION 
TR  (IE- WHILE 
FALSE-WHILE 


All  naae  types 

PROCESS 

ENTITY 

SET 

SET 

RELATION  and  SET 

CONDITION 

CONDITION 


fo  rm  a_t 

An  entry  in  the  report  is  printed  for  each  coaaent  entry 
Dresented  for  each  naae  qiven  as  input.  Each  entry  is  nuabered 
1*,  2*,  etc.  The  foraat  of  each  entry  is: 

f*  name 

coai ent-ent  r y-statea  ent ; 

[comment  entry  text]; 

?ach  line  of  the  comment  entry  text  is  numbered  within  a given 
report  entry. 


Options  and  Alternatives 

An  entry  in  the  report  is  produced  for  each  consent  entry  (as 
specified  by  the  parameters  for  the  command  generated  the 
report)  available  for  each  name  qiven  as  input.  The  following 
parameters  designate  the  comment  entries  to  be  presented: 
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DERIVATION  DESCRIPTION  FALSE-WHILE 

PROCEDURE  TRUE-MHILE  VOLATILITY 

VOLATILITY- HEHR  FR  VOLATILITY-SET 

Any  of  these  parameters  prefixed  with  "NO"  specifies  that  the 
corresponding  consent  entries  are  not  to  be  presenter)  in  the 
report. 


AaftlYSiS 

Each  nase  given  as  input  to  the  software  generating  the  report 
is  searched  for  in  the  data  hasp.  If  it  is  not  found  the 
message: 

DRA135:  MATNPCON:  NAME  NOT  FOUND  IN  DATA  BASE  - 

is  nrinted.  If  the  name  is  found  then  those  cosnent  entries  (as 
specified  hy  the  parameters)  which  are  available  for  it  are 
printed  on  the  report. 


Usarje 

"he  report  nay  he  U3ed  hy  analysts  to  check  the  availability  of 
specific  types  of  comment  entries  for  a class  of  names.  For 
example,  to  check  that  all  SETS  have  VOLATILITY-MEMBER, 

VOL*  TIT.ITY-S  E",  and  DERIVATION  comment  entries  the  commands: 

NAME-GEN  S»*SET» 

PUNCH-COHMENT-ENTRY  VOL  ATI  LIT Y- MEHB ER  VOLATILITY-SET 
DERIVATION 

can  he  given. 


Examples 

figure  56  presents  the  report  for  the  name 
'•sal aried-em ploy ee- processing . •» 
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£SI£BafiS 

To  '‘stimate  the  amount  of  the  resources  that  are  consuaad  by  tha 
processors  In  performing  a liven  root  process. 


Z&l°XS£li<2&  El2§£I!t2i 

The  RESOURCE  CONSUMPTION  Report  can  present  two  kinds  of 
information: 

a)  for  each  processor  which  is  used  to  perform  the  given  root 
process  the  following  appears: 

1)  The  naee  of  the  processor. 

2)  The  frequency  of  processor  use  in  teres  of  a user 
supplied  interval. 

A list  of  naaes  of  the  resources  that  the  processor 
consuaes  together  with  the  amount  consulted  and  the  unit  in 
which  the  resource  is  measured, 

M For  each  resource  consumed  when  the  root  process  is 
performed  the  following  appears: 

1)  A list  of  naaes  of  the  processors  which  consume  the 
resource  together  with  the  frequency  of  usage  in  terms  of 
the  specified  interval  and  the  amount  of  the  resource 
con  snmed . 


laissi 

"‘h"  format  for  the  PROCESSOR  and  RESOURCE  information  i3  as 
shown  in  the  following  example: 


PROCESSOR  PE^EP 

RESOURCE  CONSUMED 

R1 

P2 

<n 


IS  INVOKED 

AMOUNT  CONSUMED 

145768 

10512 

1644 


64  TIMES  PER  TEAR 

MEASURED  IN 

DOLLARS 

TONS 

MICROSECONDS 


PESnnpcr  R1 


MEASURED  IN  DOLLARS 
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PROCESSOR  CONSUMING 

FR  FQOENCY 

AMOUNT  CONSUMED 

PETFR 

6« 

1 W 5768 

SAM 

52 

592800 

FRED 

12 

612 

TOTALS 

12« 

739180 

jpti ons  anj  Ali2£D3til£§ 

If  one  is  only  interested  in  a certain  type  of  processor,  the 
PPOC ESSOn-KF Y WOR D parameter  nay  be  specified.  In  this  case,  the 
processor  part  of  the  report  will  be  broken  into  two  sections. 
The  firs*-  section  will  show  those  processors  which  have  the 
specified  keyword,  and  the  second  section  will  list  all  the 
other  processor  undpr  the  heading  "OTHER  PROCESSORS." 

The  resource  Dart,  of  the  report  will  also  be  altered  if  the 
p^PC eesp »-KE YWOP D parameter  is  specified.  For  each  resource, 

►he  processors  which  have  the  specified  keyword  are  first  listed 
and  the  other  processors  that  consuie  the  resource  are  listed 
under  "OTHER  PROCESSORS." 

■"he  PROCESS- 1 EVFL=nu  m ber  parameter  does  not  change  the  format  of 
the  output,  but  it  is  used  to  control  the  "level  of  detail"  of 
the  analysis.  Only  as  many  levels  as  specified  in  this 
parameter  will  be  probed  in  the  process  structure  beginning  at 
tha  root-process. 

When  the  output  is  expected  to  be  fairly  large  (i.e.  , contains 
many  user-names  in  it),  it  is  advantageous  to  specify  the  INDEX 
parameter  to  qenerate  an  index  report  that  shows  all  tha 
user-names  that  appear  in  the  report  and  the  report  page 
number(s)  on  which  they  appear. 


inaiisis 

”hn  program  searches  the  data  base  for  each  process  name  given 
as  input.  if  the  name  is  not  found,  the  message: 

URAC59:  PRPPRO;  ROOT  PROCESS  NOT  FOUND  IN  DATA  BASE  - 

is  printed  and  no  information  is  presented  for  that  process 
name . 

If  the  process  is  found  in  the  data  base,  the  program  then 
performs  a walk  of  the  suhpa rts-utilizes  network  which  starts  at 
the  specified  process  name  and  extends  downward  to  the  specified 
number  of  levels.  »or  each  visit  to  each  process  in  tha 
structure,  the  resource  consumption  and  processor  frequancy 
information  is  computed  and  recorded.  After  the  network  has 
been  traversed,  the  recorded  information  is  printed. 
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It  is  important  to  realize  that  a process  say  be  visitel  eore 
than  once,  and  that  its  resource  consumption  is  cosputei  each 
tine  it  is  visited.  This  corresponds  to  the  fact  that  * 
component  process  nay  be  oerformed  many  times  as  a root  process 
is  performed  once. 

For  the  network  shown  below,  where  continuous  lines  represent  a 
subpart  relation  and  broken  lines  represent  a utilizes  relation, 
processes  PI,  P2,  Pi,  P9,  P5,  P6,  P8  and  P9  are  each  counted 
once.  Processes  P7,  pi  1 , pi  2 and  P13  are  each  counted  three 
times.  Process  pi?  is  counted  twice,  And  process  Pin,  P15  and 
P16  are  each  counted  eight  tines. 


/ \ 


PI  9 PI  6 


Thus,  a verv  simol?  structure  can  qenerate  a larqe  number  of 
conputat ions . 

■"he  proqram  expects  to  find  the  following  inforaation  in  the 
data  haso: 

- Each  process  must  have  a frequency  value.  The  frequency  valua 
must  be  convertible  to  "times  per  given  INTERVAL."  The  program 
will  onlv  make  one  level  interval  conversions.  For  example,  if 
the  following  information  is  in  the  data  base: 

YEAR  CONSISTS  OF  S2  WEEKS; 

WET KS  CONSISTS  OF  7 PATS; 

Then  the  program  will  convert  weeks  to  years  or  years  to  weeks 
but  will  not  convert  years  to  days  or  days  to  years.  For  this, 
the  statement; 

TEAR  CONSISTS  OF  3*5  DAYS; 
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must  be  given. 

- Each  process  ■ list  he  perforned  by  exactly  one  processor. 

If  the  above  conditions  are  not  met,  error  messages  will  be 
printed  and  the  analysis  mill  be  incomplete. 


1!§13£ 

’’’he  report  can  be  used  to  estimate  the  usage  of  the  resources 
that  are  consumed  by  the  processors  in  performing  a given 
process.  The  estimate  is  accumulated  for  a given  interval  based 
on  the  user-specified  resource  usage  parameters  for  each 
processor  and  the  resource  usage  parameters  which  are  components 
of  the  oiven  process. 


Examples 

figure  57  represents  the  output  of  the  following  coumanl: 

RCA  N=hourly-employee-processing  PL=50  INT=week  BP  BR 

PK  = A LL 

Moure  58  represents  the  output  of  the  following  command: 

NG  3=,SD  = ho'jr  ly — pay  chec  K—  product  ion  * NOPRINT 
RCA  F INT=week 
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§i£S£in  hUkisis  ms£i 


EUEE2SS 

To  identity  security  conflicts  in  the  desiqn  of  the  target 
syst  em. 


iQfQEMiian  £isssnl9i 

For  each  naae  received  as  input,  the  report  prints  a Message  for 
each  security  conflict  associated  with  that  nane  and  than,  at 
the  end  of  the  report,  prints  a Matrix  which  suaaarizes  the 
security  conflicts  encountered  for  all  the  naaes  received  as 
input. 

Optionally,  the  report  also  produces  a list  of  those  naaes  in 
the  data  base  for  which  security  infornation  is  possible  but  for  *• ; 

which  such  infornation  does  not  exist.  **■] 


Z°£S£t 

The  fornat  of  the  raport  is  sel f-explana tory. 


2 1?  U 213  all  Aite£j>atives 

"here  are  only  two  options:  j-: 

1)  Whether  or  not  to  have  an  index  produced. 

2)  Whether  or  not  to  include  a list  of  naaes  without  security 
infornation. 


"he  program  searches  the  data  base  for  each  naae  given  as  input. 
Tf  the  name  is  not  found,  the  nessaqe: 

UFA195:  HAINSRCA  : NAME  NOT  FOUND  TN  DB  - user-name 

Is  printed  an  no  infornation  is  presented  for  that  nane.  The 
tyne  of  the  nane  is  then  checked.  If  its  type  does  not  sake 
sense  in  the  context  of  the  Security  Analysis  Report  the 
nessaqe: 

URA2C  3:  1AINSECA  : INPUT  NANE  HAS  INVALID  TYPE 
is  printed  and  no  infornation  is  presented  for  that  nane. 


Tf  the  nane  is  a data  type  (i.e.,  SET,  INPUT,  OUTPUT,  ENTITY, 
GROUP  or  ELEMENT)  the  following  steps  are  taken: 
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1)  For  every  name  contained  in  the  qiven  name,  every 

classification  of  the  contained  name  is  checked  to  see  that 
the  qiven  (containing  name  has  the  same  classification  at 
a level  greater  than  or  equal  to  the  level  of  the  contained 
name. 

?)  por  evorv  ''RPCESS,  PROCESSOR  or  INTERFACE  which  accesses 
the  given  name,  every  classification  of  the  qiven  name  is 
checked  to  see  that  the  accessor  has  the  sane 
classification  at  a level  greater  than  or  equal  to  the 
level  of  *he  qiven  (accessed)  nana. 

If  a classi  f icat.  ion  is  found  missinq,  or  a level  nisnatch  occurs 
ir.  one  of  the  ahove  steps,  in  appropriate  nassage  is  printed 
which  explains  the  security  conflict. 

If  the  qiven  name  is  a PROCESS,  PROCESSOR  or  INTERFACE,  then  tha 
following  occurs  tor  each  na  ne  in  the  suhparts  structure  of  the 
qiven  name. 

Each  classification  of  each  data  item  that  the  name  accesses  is 
checked  to  see  that  the  accessing  name  has  the  same 
classification  at  a level  greater  than  or  equal  to  the  level  of 
the  accessed  item.  Tf  not,  an  appropriate  message  is  printed. 


£ 

The  report  can  he  used  to  check  the  consistency  of  the  security 
provisions  of  the  tarqet  system  and  to  identify  components  of 
the  system  for  which  no  security  provisions  exist. 


°x  am  ules 

Mqure  represents  the  output  of  the  following  command: 

SEP A v=hourl y-paych»ck-validation  PNSI  PNAT  NOINOEX 


depat  t«*nt  - f i 1 * h i r.  no  n*?~urity  information 


curity  Analysis  Paporf 
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STRUCT]]]?? 


Purpose 

”o  present  the  implied  hierarchy  of  PROCESSES,  INPUTS,  OUTPUTS, 
INTERPACES  jr  PROCESSORS  defined  in  the  Analyzer  data  base,  fro* 
vhe  use  of  the  SUBPAPTS  statements  relating  thee. 


Information  Presented 

The  report  presents  all  EUBPARTS  structures  for  a given  class  of 
names  (TN"ERFACES,  INPUTS,  OUTPUTS,  PROCESSES  or  PROCESSORS)  as 
specified  by  ♦'he  parameters  when  generating  the  report. 

The  structures  start  with  all  names  which  are  not  PART  of  any 
higher  structure.  These  names  are  designated  level  1 names. 

The  SUBP ARTS  of  level  1 names  are  presented  as  level  2 names. 

The  SUBPARTS  of  the  level  2 names  are  then  presented  and  so  on. 


Format 

The  report  presents  the  structures  under  three  headings:  COUNT, 
LEVEL,  and  N AMF.  NAME  presents  the  name  of  the  object  in  the 
structure,  LEVEL  presents  the  level  number  associated  to  the 
name  corresponding  to  its  position  in  the  structure  and  COUNT 
oresents  the  position  (line)  in  the  report  where  the  name  is 
printed  out.  Bach  level  is  indented  (as  specified  by  the  INDBNT 
parameter)  to  further  accent  the  idea  of  structure. 

A summary  section  for  the  report  provides  a count  (under  the 
COUNT  heading)  of  the  number  of  names  presented  at  a given  level 
(as  designated  by  the  LEVEL  heading). 


§nd  Alte^nj^ixes 

"he  INPUT,  OUTPUT,  PROCESS,  INTERFACE  and  PROCESSOR  parameters 
for  the  command  specify  which  type  of  names  the  report  will  be 
produced  for.  One  and  only  one  of  these  parameters  may  be 
specified  for  the  command  producing  the  report. 

"he  number  of  spaces  which  each  level  of  the  structure  is 
indented  may  be  assigned  by  the  INDENT  parameter.  If  no  value 
is  given  INDFNT  defaults  to  3,  but  may  take  on  any  value  from  1 
to  10. 

An  INDEX  for  the  report  is  produced  when  the  INDEX  paraieter  is 

used . 
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A chock  is  made  that  at  leaat  one  name  (of  the  name  type 
dosi  gnatod  hy  the  parameters)  exists  in  the  data  base  which  is 
not  PAR"  of  a larger  structure,  I f no  such  name  exists  the 
message: 

n?A2*B:  STATPS:  NO  names  at  level  one  - 

is  printed.  wor  each  name  found,  its  SUBPAPTS  structurm  is 
traced  anl  presented  in  the  report. 

Ff  a loop  is  encountered  in  the  structure  the  message: 

I1T>A2ec:  PRFPS:  THE  FOLLOWING  NAMES  ARE  INVOLVED  IN  LOOPS  - 
is  printed  with  the  names  involved. 

Should  the  structure  consist  of  more  than  50  levels  (tha  limit 
that  the  software  has  been  designed  to  handle)  the  message: 

URA284:  MAINSTR:  TOO  MANY  LEVELS  - CONTINUING  - 

is  printed. 


ns_a  <1£ 

"he  report  is  an  aid  to  analysts  in  maintaining  consistency  in 
structures  defined  for  the  target  system  description. 

Especially  where  a top-down  approach  is  being  used,  the  analyst 
is  concerned  that  names  have  been  inserted  into  the  prooer  level 
of  a strucutre. 


Examples 

*‘icnire  60  presents  a STRUCTURE  report  for  INPUT  names.  figures 
*1,  62,  61  and  64  present  STRUCTURE  reports  for  OUTPUT, 
TNTEPrACF,  PROCESS,  and  PROCESSOR  names,  respectively. 
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=5  U MMAPT  DP  2HE  DftTA  BASE 


£S1£E2£2 

This  report  provides  statistical  information  with  respect  to  the 
usage  of  different  name  types  (o.g.,  PROCESSES,  ELEMENTS,  etc.) 
and  can  be  used  as  an  aid  in  estimating  size  of  the  Language 
description  in  an  Analyzer  data  base. 


~rnf o rwa * ion  Presen t ed 

"he  reDort  provides  an  entry  for  each  different  name  type 
(PROCESS , ELEMENT,  ate.)  defined  in  a particular  data  base.  Por 
example,  if  only  PROCESSES  have  been  defined,  only  a PROCESS 
entry  will  appear  in  the  report.  Eor  each  name  type  the  report 
entry  presents: 

- The  number  of  names  in  the  data  base  of  that  name  type  (COUNT* 

- The  number  of  these  names  that  have  SYNONYMS  (tli/SYN) 

- *he  percentage  of  these  names  with  SYNONYMS  (PERCENT) 

- The  number  of  th?3e  names  that  have  a DESCRIPTION  (f«/DESC) 

- The  percentage  of  these  names  with  a DESCRIPTION  (PERCENT) 

An  entry  is  also  provided  consisting  of  all  of  the  above 
considering  all  name  types  (**T0TAL**)  in  the  data  base. 


pormat 

The  reoort  presents  six  columns  of  information  as  follows: 

name-t.ypa  COUNT  #W/SYN  PERCENT  #W/DESC  PERCENT 

in  a table  format.  A row  of  the  table  consists  of  values  for 
each  or  the  above  columns.  A row  is  presented  for  each  name 
type  defined  in  the  data  base  and  the  name  types  are  presented 
in  alphabetical  order.  A row  is  also  printed  presenting  the 
total  for  each  column.  Since  there  are  a limited  number  of  name 
types,  the  report  always  fits  on  one  page. 


QEU2E2  aai  AU*EHaUl£s 

"’here  are  no  options  available  for  this  report. 
Anal vsis 
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7h“  software  generating  the  report  looks  at  every  name  in  the 
lata  base  and  uplates  three  fields  according  to  its  name  type 
( COUNT) , whether  or  not  it  has  a DESCRIPTION  (iW/DESC),  and 
whether  or  not  it  has  any  SYNONYMS  (iW/SYN).  After  all  nates 
have  been  looked  at,  percentages  (PERCENT)  for  these  nates  with 
DESCRIPTIONS  and  SYNONYMS  are  computed  within  each  name  type. 

finally,  totals  are  produced  for  values  retrieved  for  each  table 
headinq  and  are  printed. 

If  *"he  report  is  generated  for  an  empty  data  base,  the  message: 

NO  NAMES  IN  D.B.- 

is  printed. 


usa^e 

The  ma-jor  benefit,  of  this  report,  is  to  prolect  management 
personnel  in  recording  progress  heinq  made  in  the  target  system 
description  procedure.  Comparing  a particular  DATA  BASE  SUMMARY 
with  previous  summaries  allows  management  to  see  where  some  of 
the  work  effort  has  been  concentrated.  Por  example,  if  52 
PROCESSES  are  counted  in  the  report  compared  to  12  previously, 
it  shows  that  the  malor  prolect  effort  has  been  centered  around 
definition  of  PROCESSES. 

General  progress  may  be  evaluated  by  looking  at  the  totals 
presented  for  successive  reports. 


pxam  pl«>s 

Eigure  65  presents  the  SUMMARY  generated  from  a description  of  a 
target  system. 
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Eil£222S 

To  provide  a reference  into  a particular  UR*  report  to  Locate 
all  occurrences  of  the  use  of  a particular  user  defined  na  ee  in 
the  report. 


Information  Presented 

The  report  presents  all  the  user  defined  naaes  used  in  a given 
'IPA  report,  which  Bust  he  one  of  the: 

CONTENTS  REPORT 
DICTIONARY  REPORT 
"XTVNDED  PICTURE 
FORM  AT^ED-PROBL^M-STATEMENT 
PICTURF 
PROCESS  CHAIN 
PROCESS  INPHT/OOTPUT  or 
STRUCTUP  E, 

the  oaue  nuahers  in  the  report,  where  each  naae  occurs,  and  the 
nnnher  of  tines  the  naae  appears  within  the  pages  it  occurs  (if 
more  than  once)  . 


format 

The  report  consists  of  an  entry  for  each  naae  used  in  one  of  tha 
above  reports.  The  entry  consists  of: 

-the  naae  presented  in  the  report. 

-♦•he  oaqe  nuahers  (separated  by  coaaas)  that  the  naae  occurs  on 
in  the  report. 

-the  nuaber  of  occurrences  (enclosed  in  brackets)  of  the  naae  on 
a particular  paqe. 

Each  entry  is  numbered  and  the  entries  are  arranged  in 
alphabetical  order  by  naae. 


12H223  an!  llismUisi 

Th*»rp  are  no  options  for  this  report. 


Inalx2l2 

The  input  for  the  software  producing  the  INDEX  is  obtained  froa 


i 

i r 
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i 
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on*1  of  the  roport-pr oduci  nq  nodules  which  allows  the  INDEX 
naraneter.  If  no  input  is  available,  because  the  report 
presents  no  information,  the  messaqe: 

n«A2«7:  MATNIDX:  NO  NAMES  IN  INDEX 

is  printed  if  input  is  available  (in  the  fon  of  naaes  and  line 
numbers)  the  names  are  sorted  and  presented  as  the  INDEX  report. 


nsaae 

Tb^  INDEX  is  intenled  as  a reference  into  a report  for  purposes 
of  locating  all  occurrences  of  the  use  of  a particular  name  in 
the  report..  The  INDEX  is  usually  desirable  whenever  a report 
over  a few  oages  in  sire  is  to  be  generated. 


isasElss 

pigu  re  66  presents  a PROCESS  INPtjT/OUTPUT  REPORT  with  aa  INDEX. 
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USER  REQUIREMENTS  ANALYZER 


COMMAND  DHSCRITIONS 
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A note  on  version  3.2  of  UR  A 


There  are  several  important  changes  that  have  been  aade  in  URA 
which  nakes  Version  3.2  different,  than  Version  2.1. 

First,  several  internal  modifications  (which  are  transparent  to 
the  user)  have  been  made  to  make  the  URA  more  efficient.  In 
particular,  a data  base  search  index  has  been  added.  This  index 
orovides  a more  efficient  method  for  the  retrieval  of  names 
contained  in  the  data  base. 

Several  changes  have  been  made  to  the  NAME  GEN  command.  These 
chanqes  are: 

1)  the  replacement  of  the  name  grouping  parameters  (e. g. , 
PROCESS,  KE  Y*u  ser-name)  by  the  SELECTION  parameter. 

2)  the  addition  of  the  ATTRIBUTE-VALUE  ordering  option  to  the 
ORDER  parameter. 

■’’he  DISPLAY  control  command  has  been  added. 

The  MTS  conand  has  been  implemented  to  allow  the  execution  of 
Mulfics  commands  from  URA  mode.  The  new  report  commands 
RESO U PC F-CONSUKPT ION- ANALYSTS  and  SECUFITY-CONSISTENC Y-ANALYSIS 
have  been  added.  The  reports  for  Structure,  Contents,  Summary, 
and  Form atted-Pr oblem-Statement  have  been  changed  to  accommodata 
the  new  object  types  in  the  data  base. 

Names  for  ob-jects  may  now  consist  of  certain  special  characters 
(see  Appendix  T)  . 

The  HELP  command  information  has  been  updated  to  reflect  these 
chanqes. 
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I El  SEA  S2QEHE  LMSJ2A& 

"■he  URA  Coavand  Language  consists  of  three  basic  types  of 
commands: 

Report  Commands 

Modifier  Coeeands 

Control  Commands 

Report  Commands  retrieve  data  fro*  the  URA  data  base  and  output 
it  in  some  meaningful  foreat.  These  reports  do  not  change  the 
contents  of  the  data  base  whatsoever.  Their  purpose  is  solely 
that  of  displaying  orderings  and/or  relationships  within  the 
current  problee  statement.  The  following  Report  Commands  are 
available  in  this  version  of  the  Analyzer: 


CON SISTS-CO APART  SON 

CONSTSTS-MATRIX 

CONTENTS 

DATA-PROCESS 

DICTIONARY 

ENTITY-TDFNTIRIFR 

EXTENDED-PICTURE 

TO  PH  AT  TED-PROBLEM- ST  AT  SB  ENT 

PRFOUENCY 

KWIC 

NAME-GEN 

NAME-LIST 

PICTURE 

PRINT- ATTRIBUTE-VALUES 

PROCESS-CHAIN 

PROCESS -INPUT-OUTPUT 

PUNCH-  TOMME  Vt-EN  TRY 

RFSOHRC  S-CO VSUM  PTION-AN  AL Y SIS 

SEC URITT-CONSISTENCY- ANALYSIS 

STPOCTURS 

SUMMARY 

Modifier  Commands  are  intended  to  aodify  the  contents  of  the  USA 
data  base  in  the  manner  defined  by  the  problea  iefiner.  These 
coaaands  take  legal  URL  statements  or  URL  naaes  as  input.  URA 
then  generates  error  diagnostics  as  well  as  an  output  report  to 
Dresent  the  outcome  of  the  data  base  alteration.  The  following 
Modifier  Commands  ate  available  in  this  version  of  the  Analyzer: 


CHANGE-TYPE 

DELETE 

DELETE- COMM  ENT- ENTRY 
DELETE- PSL 
TNPUT-PSL 
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RFNAMF 

REPLACE-COHMENT-FNTFY 

"on*- rol  ronands  are  the  means  to  pass  certain  control 
information  to  the  User  Requirements  Analyzer.  The  SET  command, 
For  example,  allows  the  user  to  define  which  URA  data  base  is  to 
he  accessed  by  t.he  Report  and  Modifier  Commands  as  well  as 
setting  various  switches  and  assigninq  input,  and  output  files. 
Control  Commands  are  installation  dependent  and  therefore  are 
given  in  Appendix  F. 

Although  any  of  the  commands  can  be  issued  independently  of  eaca 
other,  it  is  often  advantageous  to  use  some  commands  in 
sequence.  This  means  that  output  of  one  command  can  be  used  as 
input  by  another.  The  most,  common  instance  of  this  is  when 
NAMF-GFN  is  used  to  select  certain  names  (say  all  PROCESSES  for 
example)  which  can  then  be  used  as  input  to  a Report  Command 
(possibly  ®I CTUR E , for  a PICTURE  REPORT  for  all  PROCESS  names). 


UR£  Command  Lang  uage/Inst  al  la  t.  j on  De pend encies 

UFA  is  a software  system  that  is  designed  to  be  used 
interactively  in  a time  sharinq  system  environment.  It  contains 
its  own  data  base  management  system  but  it  is  dependent  on  the 
time  sharing  operating  system  for  the  usual  facilities  of  sign 
on,  identification  and  security,  file  creation  and  editing,  etc. 

Differences  in  operating  systems  and  operations  at  particular 
installations  affect  the  way  in  which  ORA  is  executed  at  a 
particular  installation.  There  are  basically  three  aspects  of 
URA  that  are  installation  "dependent": 

1)  Control  commands 

2)  Method  of  initiating  and  executing  URA 
1)  File  names  used  by  URA 

These  dependencies  are  presented  in  the  addendum  for  th9 
particular  installation. 

URA  can  also  be  used  in  batch  mode  at  most  installations.  The 
commands  necessary  to  accomplish  this  are  also  installation 
dependent  and  are  not  covered  in  this  paper. 


£<2J!!3£d  Language  SlBlM  HfitaUfiE 


A PR  P F VI ATIDN  S 

? o enable  the  user  to  fit  a lengthy  command  on  the  slotted  line 
and  eliminate  some  of  the  tedium  of  command  specification, 
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abbreviate!  forms  for  both  commands  and  parameters  say  be  used. 
Each  abbreviation  can  be  founl  in  parentheses  immediately 
following  the  word  It  represents.  For  example,  the  comiand: 

CHANGE-TYPE  N ANE* G ROSS-PA Y TYPE* ELEMENT  can  be  written  as 

CT  N*G ROSS-PAY  T*ELEHENT 


BLANKS 

A blank  must  appear  between  the  command  and  any  accompanying 
parameter,  and  between  successive  parameters.  Several  blanks 
are  treated  as  a single  blank  and  may  be  inserted  whenever  a 
single  blank  is  necessary.  for  example: 

CT  N*~  ROSS  - PAY  T*ELSHFNT  can  be  written  as 

CT  N-GROSS-PAY  T* ELEN  ENT 


BRACES 

In  the  following  examples,  when  parameters  or  parameter  values 
are  enclosed  in  braces  ({  ))  , a choice  amonq  the  two  or  more 
entries  must  be  made.  It  i.3  important  to  note  that  one  and  only 
one  of  the  options  »usj  be  chosen.  For  example,  the  braces  used 
in  describing  the  syntax  of  the  CHANGE-TYPE  command  specifies 
that  the  command  must  either  be  of  the  form: 

CT  N*user-name  T*name-type 

or 

CT  P*fdname  [ T*name-type  ) 


RRACKFTS 

Whenever  parameter  notation  in  an  example  appears  within 
brackets  f 1),  it  indicates  a feature  the  user  may  optionally 
use.  tor  example,  the  TYPE  parameter  in  the  CHANGE-TYPE  coamanl 
is  optional  when  the  FILE  parameter  is  also  used.  Therefore, 
the  command  may  be  of  the  form: 

CT  FILE*fdname  TYPS*name-type 


CT  FILE-fdname 

The  syntax  of  the  FILE  parameter  shows  that  the  parametar  mar  b» 
given  either  as: 
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FILS*  tdname 
or  lust 
FI  LE 

No  other  variations  are  acceptable  (except  those  alreadf 
specified,  i.e.,  abbreviations,  etc.). 


COMPAND  LINF 

Each  command  must  appear  on  * separate  line  and  totally  on  that 
line.  A command  cannot  he  split  on  succeedinq  lines.  3nly 
columns  1 throuqh  f 2 of  each  line  can  be  used. 


GENERAL  COMPAND  SYNTAX 

The  command  identifiers  (name  of  the  command)  must  precede  any 
accompanying  parameter  or  list  of  parameters. 


COMMAND  PARAMETERS 

Parameters  for  a command  separated  by  one  or  more  blanks. 
Parameters  mav  be  given  in  any  order,  but  are  processed  from 
left  to  riqht.  if  conflicting  parameters  are  used,  the 
right-most  parameter,  i.e.,  the  last  one  given,  is  considered  to 
he  correct  and  is  ♦•he  one  used  in  the  processing  of  the  command. 


ELLIPSIS 

"he  ellipsis  (...)  signifies  that  the  command  construct 
immediately  precedinq  the  ellipsis  can  be  repeated  as  many  times 
as  desired  by  the  user. 


INTEGERS 

The  integers  reguired  for  parameters  must  be  positive  integers. 
If  a value  range  is  qiven  for  a particular  parameter 
description,  that  restriction  must  also  be  met. 


N ANFS 

All  user  define!  names  (user-names)  must  be  formed  from  the 
legal  character  set  presented  in  the  Appendix  B.  Note  the 
following: 


A name  can  he  any  combination  of  thirty  or  less  coie  3 or 
code  4 characters  where  the  first  character  is  a letter  or 
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other  code  1 character. 

- Blanks  cannot  he  used  in  the  naae. 

- A user  define*  naae  cannot  be  a URL  RESERVED  WORDS.  For  a 
list  o f Reserved  words  see  Appendix  B of  Part  II , URL 
User's  Maual. 

"or  example, 

GROSS- PAT,  EMPLOYEE-NUMBER,  f-of-UNITS  i S. 06/lbs. 
are  all  l eg a 1 naaes. 

PROCESS,  1 2 3- HILL- STREET,  WHY? , and  BL  ANK 

are  illeqal  naaes.  "PROCESS"  cannot  be  used  as  a user-naae 
because  it  is  a URL  Reserved  Word.  "12 3 -HILL-STREET " is  illegal 
because  it  starts  with  an  inteqer  rather  than  a letter.  "WHY" 
is  illeqal  because  it  contains  the  "?"  character  which  is  not 
allowed,  and  "BL  ANK " contains  an  iabedded  blank. 


CAPITALIZATION 

Tn  this  workinq  oapar  all  URA  coaaands,  paraaeters  and  reserved 
words  appear  in  upper  case,  in  soae  systems,  such  as  Haltics, 
where  the  standard  coaaand  convention  is  lower  case,  the  user 
should  use  lower  case  for  all  URA  coaaands,  paraaeters,  and 
reserved  words. 

• we  • • ' ' * * » 


E2£££t  of  £2£!aa£  Cassations 

All  the  URA  commands  in  this  paper  are  described  in  the 

followinq  fora.at: 

Coaaand;  C3M MAND-NAM F Type:  comaand  type 

Purpose:  This  presents  the  function  of  the  coaaand  in  the  URA 

system  whether  it  generates  a report,  aodifies  the 
data  base  or  gives  control  inforaation  to  ORA.  {The 
"U»A  Osecs  Manual"  and  "URA  Reports"  present  detailel 
descriptions  of  the  reports  generated  by  each 
coaaand. ) 

Prototype:  This  presents  the  legal  syntax  for  the  coaaand.  The 
Coaaand  Language  Syntax  Notation  specifies  what  the 
special  syabols  (such  as  braces  and  brackets) 
represent  in  interpreting  the  syntax. 

Parameters: 

For  each  parameter  available  for  the  coaaand,  this 
section  provides  a brief  description  explaining  how 
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the  parameter  changes  the  action  of  the  command. 

(Part  I and  Part  III  explain  how  to  use  these 

parameters  effectively.) 

There  are  basically  five  types  of  p&raaeters: 

Input  data  parameters  - these  paraaeters  specify 

the  data  to  be  used  as  input  to  the  command. 
PILE  and  NAME  are  examples  of  Input  data 
par  ameters. 

Input  control  parameters  - these  parameters  specify 
how  the  input  data  is  to  be  used,  changed, 
etc.,  by  the  coaaand.  The  TYPE  parameter  for 
the  CHANC.E-TYPE  command  and  CONTAINED/CONSISTS 
parameter  for  the  CONSI STS-N ATRI X coaaand  are 
examples  of  this  type. 

Dutout.  data  parameters  - these  parameters  specify  if 
output  is  to  be  generated  from  the  command  and 
the  form  in  which  it.  is  presented.  The  PUNCH 
an  PRINT  parameters  are  examples  of  this  type 
of  parameter. 

Dutnut  option  parameters  - these  parameters  specify 
options  which  may  be  included  or  omitted  from 
the  output.  The  LEVELS  parameter  for  the 
CONTENTS  command  and  the  DESCRIPTI3N  parameter 
for  the  DICTIONARY  command  are  examples  of  this 
type. 


• ■ « * »- ••:>utp'U-t  f or  mat  • parameters  - these’  parameters  specify 
alternate  formats  for  the  presenting  the 
information  in  the  output  from  the  command. 

’rhe  NPV-PA3E  parameter  and  HMARG  parameter  for 
the  EPS  command  are  examples  of  this. 

The  parameters  for  each  command  will  be  presented  in 
the  above  order  according  to  type. 

Defaults:  Th»s«  prasent  which  parameters  will  be  used  for  the 

command,  or  what  value  a parameter  will  have,  if  the 
parameter,  or  value,  is  not  explicitly  defined.  Por 
example,  if 

CONTFNTS 

is  specified,  the  defaults  for  this  command  are  such 
that  this  has  the  same  effect  as  specifying: 

CDNTFNTS  PILE  NOINDFX  LEVELS=ALL  NONCPLAG 

If  a "no  default"  is  given,  this  means  that  if  not 
explicitly  defined,  the  corresponding  parameter  will 
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not  be  used  for  the  coaaand. 

These  are  the  possible  error  aessages  that  my  occur 
if  the  paraaeters  for  the  coaaand  are  not  specified 
correctly.  The  " UR  A Users  Manual"  explains  what  to 
do  should  these  aessages  be  encountered. 

Actual  exaaple  of  the  coaaand  syntax  are  presented. 
(The  results  froa  these  exaaples  are  presentad  in 
Part  I and  Part  III.) 
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Command:  CHANGE-TYPE  Type:  sodifier  command 

Purpose:  To  change  the  name  type  of  a user  name  defined  in  the 

user's  lata  base.  A record  of  this  change  is 
generated  in  the  form  of  the  CHA  NGE-T YPE- REPD  RT . 


Prototype:  C HANGE-TY  PE(CT)  {NAME (N) =user-name  TYPE  (T)  = nime-type| 

{FILE(F)[  = fdname]  [ TYPE  (T)  = naie-  ty  pe  ]| 


Parameters: 

P ILF  ( ")  [ = f dname  ] Default:  no  default 

Wh®n  the  FILE  parameter  is  used  and  no  fdname  is 
designated,  the  contents  of  the  default  file*  are 
used  as  input  to  the  command.  This  file  is  the 
default  PfTNCH  file  for  NAME-GEN.  If  an  fdname  is 
indicated,  that  file  is  used  as  the  input  file  for 
the  command.  The  file  format  for  each  line  of  the 
inout  file  must  be  of  the  form: 

user-name  [name-type] 

Ere®  format  is  allowed  so  the  user-name  does  not  hava 
t.o  start  in  the  first  position  in  the  line.  The  two 
names  must  be  separated  by  one  or  more  blanks.  The 
name-type  is  optional.  If  a name-type  is  not 
specified  for  each  user-name,  the  name  type  for  each 
of  these  names  will  be  chanqed  to  the  type  specified 
in  'he  TYPE  parameter.  One  of  these  alternative 
methods  of  assigning  a type  must  he  used,  but  not 
both.  if  both  are  used,  all  the  names  in  tha  file 
will  be  assiqned  the  name  type  specified  by  the  TYPE 
pa  rameter . 

N A ME ( N) =u ser-name  Default:  no  default 

The  qiven  user-name  is  the  name  for  which  tha  change 
is  to  be  made.  When  the  NAME  parameter  is  used,  the 
TYPE  parameter  must  be  used  in  conjunction  with  it. 

-PYPE  (T)  =name-type  Default:  no  default 

This  parameter  specifies  the  new  name  type  to  be  used 
in  the  change.  See  Appendix  E of  "The  User 
Requirements  Language,  Language  Reference  Manual"* 
for  a list  of  all  possible  name  types. 


Innu  t- 
Cont  rol 


Tnpu  t- 
dat.a 


* The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  E. 

* Part  II,  URL  User's  Manual. 
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Messages:  If  neither  FILE  nor  NAME  parameter  are  given,  the 
error  message: 

NO  NAME  GIVEN 

mill  be  generated  by  ORA.  If  one  of  these  two 
parameters  are  given,  but  no  TYPE  is  specified,  the 
error  message: 

NO  TYPE  GIVEN  WITH  "NAME="  OR  "FILE''  PARAMETER 


will  be  given. 

Examples:  CHANGE-rYPE  NAME=GROCS-PAY  TYPE=ELEMENT 


i 


CT 


F T=ELEMENT 


CT  FILF  T=GROUP 


! 


» 

] 


■i 

l 


\ i 


Part  IV  nsec  Requirements  Analyzer  Command  Descriptions 


i 


H61PC /Mul tics/URA  User's  Manual 


219 


Coamand:  CONSISTS-COMPAPISON  Type:  report  command 

Purpose:  To  oroduce  the  CONSISTS- COMPARISON  REPORT. 

Prototype:  CONSI STS-COHPA RISON (CNC)  [ par aaeter  ]. . . 

Para  meters: 

FILE(F)  ; =FDNAHF]  Default:  PILF 


When  the  FILE  parameter  is  used  and  no  fdnaae  is 
designated,  the  contents  of  the  default  file1  are. 
used  as  input  to  the  coamand.  This  file  is  the 
default  PUNCH  file  for  NAME-GEN.  If  an  fdnaie  is 
indicated,  that,  file  is  used  as  the  input  file  for 
the  command  and  the  report  is  produced  using  all  the 
names  in  the  file.  In  any  case,  the  naaes  in  the 
input,  file  aust  be  SET,  INPUT,  OUPUT,  ENTITY  and/or 
GPOtiP  names.  The  format  of  the  input  file  aust  be 
one  name  per  line. 


CNC 

CNC  FILE 


* The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  E. 


Tnpu  t- 
Da  ta 


Exam  pies: 


i 


t 
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Coaaand:  CONSISTS-M ATRTX  Type:  report  coaaand 

Purpose:  To  produce  the  CONSISTS  MATRIX  REPORT. 

Prototype;  CONSI STS- K ATRI X (CM)  (CONTAINED  (CNTD) ) 

(CONSISTS  (CSTS)  | [ par ai et  er  ]. . . 


Para  aeters: 


Input-  FILE ( E) ' * FDNAHE  ],  NAME  (N) =user-na»e  Default:  PILE 

Data 

When  the  FILE  parameter  is  used  and  no  fdnaae  is 
desiqnated,  the  contents  of  the  default  file1  are 
used  as  input  to  the  coaaand.  This  file  is  the 
default  PONCH  file  for  NAME-GEN.  If  an  fdnaae  is 
indicated,  that  file  is  used  as  the  input  file  for 
the  coaaand.  When  a name  is  specified  via  the  NAME 
parameter,  the  report  is  produced  only  for  that  name. 
The  format  of  the  input  file  aust  be  one  name  per 
line. 


Tnput-  CONTA  INED  (CNTD)  , CON  SI  STS  (CSTS)  Default:  no  default 

Cont  rol 

Since  no  default  exists,  one  of  the  above  must  be 
specified.  If  CONTAINED  is  qiven,  the  naaes  used  as 
input  must  be  ELEMENT,  GROUP,  ENTITY,  INPUT  and/or 
OUTPUT  names.  If  the  CONSISTS  parameter  is  qiven  the 
names  used  as  input  must  be  SET,  ENTITY,  INPUT, 

OUTPUT  and/or  GROUP  names. 

Messaqes:  If  neither  CONTAINFD  nor  CONSISTS  is  specified,  the 
m essa  qe: 


MUST  GIVE  EITHEP  CONSISTS  OP  CONTAINED  PARAMETER 
will  be  printed. 

Examples:  CM  N= EMPLOYEE- NUM BSR  CNTD 


CM  FILE  CSTS 


CM  CSTS 


* The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  qiven  in  Appendix  E. 


I 
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Command:  CONTENTS  Typo:  Report  command 

Purpose:  To  produce  the  CONTENTS  REPORT. 

Prototype:  CONTENTS  (CONT)  [parameter]... 

Para  meters: 

Input-  PILE  ( [=  fdnaae  ],  NAME  (N)  =user-name  Default:  PILE 

Da  ta 

When  the  FILE  parameter  is  used  and  no  t d name  is 
designated,  the  contents  of  the  default  file*  are 
used  as  input  to  the  command.  This  file  is  the 
default  PUNCH  file  for  NAME-GEN.  If  an  fdnaie  is 
indicated,  that  file  is  used  as  the  input  file  for 
the  command  and  the  report  is  produced  for  all  the 
names  in  the  file.  When  a name  is  specified  by  the 
NAME  parameter,  the  report  is  produced  for  that  name 
alone.  In  any  case,  the  names  used  as  input  to  the 
command  must,  he  SET,  INPUT,  OUTPUT,  ENTITY  and/or 
GROUP  names.  The  format  of  the  input  fiLe  must  he 
one  name  per  line. 

output-  INDEX  ,NOINDFK  Default:  NOINDBX 

Data 

The  INDEX  parameter  specifies  the  production  of  an 
index  for  the  report  consisting  of  an  alphabetical 
listing  of  all  names  used  in  the  report  and  the  pages 
on  which  they  occur. 

Output.-  LEVELS=(integer}  Default:  LEV  ELS  = ALL 

Option  [ALL  } 

The  LEVFLS  parameter  specifies  the  lowest  level  of 
subordinate  names  to  he  outputted.  The  ALL  value 
indicates  that  all  subordinate  names  should  be 
outputted.  LEVELS  can  take  on  any  integar  value  fro* 
1 to  SO. 

NOVLAG,NDNCFLAO  Default:  N3NCFL AS 

The  NOFLAG  parameter  flags  all  GROUPS  in  the  output 
reports  that  do  not  CONSIST  of  anything  else,  and 
those  undefined  names  which  are  contained  in  a GROUP, 
INPUT,  OUTPUT,  ENTITY  or  SET. 

PRINT-SFCURITY-IN FOR  NATION (PS  I)  , 

NO-PRINT- SECURITY- IN  FORMATION  (NPST) 

Default:  PSI 


* The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  E. 
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The  PSI  parameter  requests  that  the  classification  of 
each  entry  be  printed. 

Exaaples:  CONTENTS  N* VARYING- EMPLOY BE- DATA 

CO  NT  P 
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Command:  DATA- PROCESS  Type:  report  command 

Purpose:  To  produce  the  DATA  PROCESS  REPORT. 


Prototype:  D AT  A- PROCFSS  (DP) 

(DATA  (D)  } ( paraneter  J.  . . 

(PROCESS  (P)  } 

Parameters: 

Tnput-  FILE ( P)  ( = f dname ],  NAME(N)  =user-name  Default:  PILE 

Data 

When  the  FILE  parameter  is  used  and  no  fdnaae  is 
desiqnated,  the  contents  of  the  default  file*  are 
used  as  input  to  the  coaaand.  This  is  the  default 
PUNCH  file  for  NAME-TEN.  If  an  fdnaae  is  indicated, 
that  file  is  used  as  the  input  file  for  the  command. 
The  format  of  the  input  file  must  be  one  name  per 
l ine. 

When  a name  is  qiven  via  the  NAME  parameter,  the 
report  is  produced  only  for  that  name. 

Input-  DATA  (0)  , PROCESS  (P)  Default:  no  default 

Con*  rol 

Since  no  default  exists,  one  of  the  above  must  be 
specified.  If  DATA  is  specified,  the  names  used  as 
input  to  the  conand  must  be  SET,  INPUT,  OUTPUT, 
ENTITY,  TROUP  and/or  ELEMENT  names.  If  PROCESS  is 
specified,  the  names  used  as  input  to  the  command 
must  be  PROCESS  names. 

Output-  DPIA" , N 0 PPM  AT  Default:  DPM  AT 

Options 

With  the  PPMAT  parameter  in  effect,  the  DATA  PROCESS 
INTERACTION  MATRIX  is  presented  as  part  of  the 
report.  When  NODPMAT  is  specified,  this  matrix  is 
not  printed. 

PPANL,  NODPANl  Default:  DPANL 

With  the  DPANL  parameter  in  effect,  analysis  is  done 
on  the  DATA  PROCESS  INTERACTION  MATRIX  (whether 
printed  or  not)  and  presented  as  the  DATA  PROCESS 
INTERACTION  ANALYSIS.  When  NODPANL  is  specified, 
this  analysis  is  not  done. 

PMAT,  NOPMAT  Default:  PNAT 


* The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  qiven  in  Appendix  E. 
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with  the  PHAT  parameter  in  effect,  the  PROCESS 
INTER ACTION  MATRIX  is  presented  as  part  of  the 
report.  When  NOPHAT  is  specified,  this  aatrix  is  not 
print  ed. 

PANL,  NOP  A NL  Default:  PA  NL 

With  the  PANL  parameter  in  effect,  analysis  is  done 
on  the  PROCESS  INTERACTION  MATRIX  (whether  printed  or 
not)  and  presented  as  the  PROCESS  INTERACTION  MATRIX 
ANALYSIS.  When  NOPANL  is  specified,  this  analysis  is 
not  done. 

If  neither  DATA  nor  PROCESS  is  specified,  an  error 
aessa  ge: 

MOST  3IVE  EITHER  "DATA"  OR  "PROCESS"  PARAMETER 
will  he  printed. 

DP  N* PAY  ROLL-PROCESSING  PROCESS 
DP  DATA 
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Command:  DELETE 


Type:  Modifier  comand 


Purpose:  To  delete  a name  or  list  of  names  fro*  the  dita  base. 

When  a nine  is  deleted  all  of  its  connections  to 
other  names  in  the  data  base  are  also  delete!.  A 
permanent  record  of  the  change  is  also  ganerated  in 
the  for*  of  the  DELETION  REPORT. 


Prototype: 


DELE1'  E (DEL) 

(FILE  (P)  [ = fdname  ] ) 
{NAHE(N)  =user-name| 


Para  meters: 


Inpu  t 
Data 


PILE  (P) ; -f  drame]. 


Messages 


cxamnles: 


NAME  (N)  = user-name 

Default: 


no  default 


When  thP  FILE  parameter  is  used  and  no  fdnaae  is 
designated,  the  contents  of  the  default  file*  are 
used  as  input  to  the  command.  This  file  is  the 
default  PUNCH  file  for  NAME-GEN.  If  an  fdnaae  is 
indicated,  that  file  is  used  as  the  input  file  for 
the  command  and  all  names  in  the  file  are  deleted 
from  the  data  base.  The  format  of  the  input  must  be 
one  name  per  line.  when  a name  is  specified  by  the 
NAME  parameter,  that  name  is  deleted  from  the  data 
base. 

If  neither  the  FILE  nor  NAME  parameter  is  specified, 
the  message: 

NO  NAME  OR  PILE  WAS  SPECIFIED 
mill  be  g i yen . 

DELETE  N=FIELD-CHECK-NEW 
DEL  FILE 


1 The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  E. 
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Command:  D ELET E-CO  MR ENT -ENTRY  Type:  Modifier  coniand 

Purpose:  To  delete  from  the  data  base,  for  the  given  naie  or 

list  of  naies,  those  comment  entries  associated  with 
each  comment  entry  statement  specified  in  the  list  of 
parameters.  A permanent  record  of  the  change  is 
generated  in  the  form  of  the  DELETED  SORBENT  ENTRIES 
r enor  t . 

Prototype:  DELETE-COKMENT-ENTRY  (DCOM) 

{FILF  (P)  [ =f  dname  ] } 

(N  ARE  (N)  =user-name|  [ parameter  ]. . . 


Parameters: 


Input-  PILE(F)  [ = f dname  ],  N ARE  (N)  =user-name 

Data  Default:  no  default 


When  the  FILE  parameter  is  used  and  no  fdnaae  is 
designated,  the  contents  of  the  default  file1  are 
used  as  input  to  the  command.  This  file  is  the 
default  PUNCH  file  for  NAME-GEN.  If  an  fdnaie  is 
indicated,  that  file  is  used  as  the  input  file  for 
the  command.  When  a name  is  given  via  the  NAMF 
parameter,  only  the  specified  comment  entries  for 
that  name  are  deleted.  Either  PILE  or  NAHE  just  be 
given  but  not  both.  The  format  of  the  input  file 
must  be  one  name  per  line. 

Tnnut-  When  given  as  parameters,  the  comment  entries  for  the 
Control  following  comment  entry  statements  are  deleted. 

DERIVA'rIDN  (DERT  , NODERIVATION  (NDER)  DefauLt: 

N JDERIVAT TON 

DESCRIPTION  (DE SC)  , NODESC RT  PT  ION  ( N DESC) 

NODESCRIPTTON 


PALSE-WHILE(PW)  , NOFALSE-WHIL  E (NPW)  NO  FALSE- 1 MILS 

PROCEDURE  (PRCD) , NOPROCEDURE (NPRCD)  NOPROCEDURE 

TRUE-  WHILE  (TW)  , N OTR  'JE-  WHI LE  ( NTW)  NOTRDE-NJ  IT. E 

VOLATILITY  (VOL)  , NOVOLATILITY  (NVOL)  NOVOLATILITY 

VOLATILITY-REP  PER  (VOLM)  , NOVOLATILITY- R ERBER  (NVOLR) 

NOVOLATILITY -BERBER 


* The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  giver,  in  Appendix  E. 
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VOLATILITY-SET  (VOLS)  , NOVOLATILIT Y-SET  (NVOLS) 

NOVOLATILITY-SET 

output-  PPINT , NOPRINT  (NP)  Default:  PRINT 

Data 

The  print  parameter  initiates  the  production  of  a 
printed  DELETED  COMMENT  ENTRIES  report.  NOPRINT 
suppresses  the  printinq. 

Messages:  If  neither  the  FILE  nor  NAME  parameter  are  given,  tha 
messa  qe: 

NO  NAME  OP  FILF  SPECIFIED 
is  printed. 

■xamples:  DELFT  F.-C0  M MEN! -EN  TRY  N = N EN-IN  FO- V ALIDA  TIDN  PRCD  DESC 
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Command:  DELFTE-PSL  Type:  aodifier  command 

Purpose;  To  delete  specific  UPl  stateaents  in  the  problem 

definer's  data  base.  Those  stateaents  used  as  input 
►o  the  command  are  deleted.  A permanent  record  for 
the  change  is  generated  in  the  fora  of  the  DELETED 
UPL  report. 

Prototype:  DELFT E-PSL  (DPSL)  [parameter]... 

Paraaeters; 

Input-  INPUT  (l|  r »fdnaae]  Default:  lNPUT=terminai 

Data 

When  INPUT  is  used  and  an  fdname  is  specified,  the 
contents  of  the  designated  fdnane  are  used  as  input 
to  the  command.  This  input  must  be  in  the  same 
format  allowable  by  the  INPUT-PSL  command  (i. e. , 
legal  URL  statements) , The  only  exception  is  that  no 
comment  entry  statements  are  allowed  in  the  input 
(DESCRIPTION,  for  example).  The  EOF  statement 
t.erminatas  input.  if  no  fdnane  is  specified,  its 
value  defaults  to  the  terminal  so  that  the  URL 
statements  can  he  entered  interactively. 

output-  SOURCE(S)  , N0S0URC5  (NS)  Default:  SOURCE 

Data 

when  the  SOURCE  parameter  is  in  effect,  an  AS-IS 
SOURCE  LT  STING  (the  DELETED  URL  output)  of  the 
deleted  UPL  statements  is  produced.  When  the 
NOSOURCE  parameter  is  given,  no  AS-I3  SOURCE  LISTING 
is  produced. 

XP?P(X),  NOXREF  (NX)  Default:  NOXREF 

The  user  may  desire  a cross  reference  for  the  AS-IS 
SOURCE  LISTING.  This  consists  of  a list  of  all 
user-defined  names  from  the  input  file  and  the  line 
numbers  on  which  they  occur  in  the  DELETED  URL 
report.  To  accomplish  this,  the  problem  definer 
should  specify  XPFP.  When  NOXFEP  is  in  effect,  no 
cross  reference  is  produced. 

Example:  DEL:!TE-PSL  NS 

DPSL  X 


i 
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Command: 


DICTIONK  R Y 


Type:  report  command 


Puroose:  To  pcoduce  the  DICTIONARY  REPORT  for  a naae  or  list 

of  na  *ps  in  the  user's  data  base 

Prototype:  DICTIONAR  Y (DTCT)  ( pa ra aeter  ].  . . 

Parameters: 


In ou  t- 
Data 


FTLE(w)[5Sfdname],  N AME  (N)  =user-name 

Default : 


FILE 


When  the  FILE 
designated,  t 
used  as  input 
default  PUN^H 
indicate! , th 
production  of 
specified  via 
generated  for 
innut  file  mu 


parameter  is  used  and  no  fdname  is 
he  contents  of  the  default  file*  are 
to  the  command.  This  file  is  the 
file  for  NAME-GEN.  If  an  fdnaae  is 
at  file  is  used  as  the  input  file  for 
the  DICTIONARY  REPORT.  When  a name  i 
t.he  NAME  parameter,  the  report  is 
that,  name  alone.  The  format  of  the 
st  be  one  name  per  line. 


Output- 

Data 


INDEX,  NOINDEX 


Default:  NOINDEX 


O'lt.put- 
Ooti  on 


when  qiven,  the  INDEX  parameter  specifies  the 
production  of  an  index  to  the  report.  This  index 
consists  of  an  alphabetical  listing  of  all  names  used 
in  the  report  and  the  page(s)  on  which  they  occur  in 
the  report. 

The  following  four  parameters  specify  the  information 
t be  included  in  the  DICTIONARY.  The  "NO"  prefix  on 
a parameter  specifies  that  such  information  not  be 
included  for  the  name(s). 


DESCRIPTION  (DESC)  , 

NO  DFS  C P IPTION ( N DESC) 


Default:  DESCRIPTION 


KEYWORDS  (KEY)  , NO  KEY  WOPDS  (NKE  Y) 

Default:  KEYWORDS 

P ^SPONSIBLE-PD  (RPD)  , 

NORFSPONSIBLE-PD(NRPD)  Default:  R ESP0NSI3  LE-PD 

SYNONYMS  (SYN)  , NOSYNONYMS  (NSYN) 

Default:  SYNONYMS 


1 The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  E. 
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Output-  NUfl-SPACE  (NS)  =integer  Default:  NUH-SPACe*2 

Format 


For  ease  in  reading,  the  number  of  lines  skipped 
between  dictionary  entries  can  be  modified  by  varying 
this  parameter.  HUM-SPACE  may  take  on  any  value 
between  ) and  10. 

Examples:  DICTIONAPY  N*PAYROLL-PPOCESSING 
DICT  FILE 
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Command:  ENTIT Y-IDFNTIFIER 


Type:  report  command 


Purpose:  To  produce  the  IDENTIFIER  INFORMATION  REPORT. 


Prototype:  ENTIT Y-ID FNTIPIER ( El)  {IDBNTI  FIER  (I)  | 

(ENTITY  (E)  } [ parameter  ].. . 

Parameters: 


Input- 

Data 


FILE  ( F)  [ = f dname  ],  NAME  (N)  =user-nane  Default:  FILE 


When  the  FILE  parameter  is  used  and  no  fdname  is 
designated,  the  contents  of  the  default  file1  are 
used  as  input  to  the  command.  This  file  is  the 
default  PUNCH  file  for  NAME-GEN.  If  an  fdname  is 
indicated,  that  file  is  used  as  in  the  input  file  for 
the  command.  If  a name  is  specified  via  the  NAME 
parameter,  the  report  is  generated  for  that  name 
alone.  The  format  of  the  input  file  must  be  one  name 
per  line. 


Inpu  t- 
Con'-  ro) . „ 


r DENT  I FI  E P (I)  , ENTITY  (E) 


Default:  no  default 


Since  no  default  is  allowed,  one  of  the  above  must  be 
specified.  If  IDENTIFIER  is  specified,  the  names 
used  as  input  to  the  command  must  be  names  used  as 
IDENTIFIERS  in  the  data  base.  If  the  ENTITY 
Daraieter  is  qiven,  the  names  used  as  input  must  be 
defined  ENTITY  names. 

If  neither  the  IDENTIFIER  nor  ENTITY  parameter  is 
specified,  the  message; 

MUST  GIVE  EITHER  ENTITY  OR  IDENTIFIER  PARAMETER 


will  be  given. 

Examples:  El  N= EMPLOYEE- NUM BER  I 


Messages ■ 


El  FILE  ENTITY 


1 The  name  of  the  dafault  file  is  installation  dependent  and 
ron seguently  is  given  in  Appendix  E. 
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Command:  '’XTFN DFD- PICTURE  Type:  report  command 

Purpose:  To  produce  the  FX  TENDED- PICTURE  report. 

Prototype:  FXTEN DED- PICTURE ( EP)  [ parameter  ]. . . 

Pa  ra  meters: 


Input-  FILE  ( F) r = f dname  ],  NA  Mw  (N)  =user-name  Default:  FILE 

Data 

When  th?  FILE  parameter  is  used  and  no  fdname  is 
designated,  the  contents  of  the  default  file*  are 
used  as  input  to  the  comand.  This  file  is  the 
default  PUNCH  file  for  NAME-GEN.  If  an  fdnaae  is 
siren,  that  file  is  used  as  the  input  file  for  the 
command.  The  format  for  the  input  file  must  be  one 
name  pec  line.  When  a name  is  qiven  ria  the  NAME 
parameter,  the  raport  is  produced  only  for  that  name. 
R eqar d less  of  whether  FILE  or  NAME  is  specified,  all 
names  used  as  input  to  this  command  lust  be  PROCESS, 
INTERFACE,  INPUT,  ELEMENT,  GROUP,  OUTPUT,  ENTITY,  or 
S ET  names. 

Output-  INDEX,  NDTNDEX  Default:  NOINDEX 

Data 


The  INDEX  parameter  specifies  the  production  of  an 
index  for  the  EXTENDED  PTCTURF  report.  This  index 
consists  of  all  user-defined  names  used  in  the 
report,  in  alphabetical  order,  along  with  ths  pages 
on  which  they  appear  in  the  report. 

Output-  STRUCTURE  (STR)  , DATA-FLOW  (DF)  Default:  no  default 
Option 


When  the  STRUCTURE  parameter  is  used,  information  is 
obtained  for  each  input  name  from  UTILIZES,  snui'ARTS, 
TONSISTS,  and  SUBSETS  statements,  or  their 
complementary  statements.  This  information  is  then 
nresentel  in  graphical  format.  When  the  DATA-FLOW 
parameter  is  used,  the  graphical  output  shows 
intormation  obtained  for  each  input  name  fro«  USED, 
USED  TO  DERIVE,  USED  TO  UPDATE,  RECEIVED,  UPJATES, 
DERIVED,  and  GENERATES  statements  or  their 
complementary  statements.  Since  there  is  no  default, 
either  STFUCTUPE  or  DATA-FLOW  fjist  be  specified. 

forward  (*WD)  , BACKWARD(BWD)  Default:  no  default 
DOWNW  ARD(  DOWN)  , UPWARD(UP) 


» The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  qiven  in  Appendix  E. 
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It  is  frequently  convenient  to  think  of  FORWARD  and 
BACKWARD  as  referring  to  DATA-FLOW  and  UPWARD  and 
DOWNWARD  as  referrinq  to  STRUCTURE.  However,  FORWARD 
and  DOWNWARD  may  be  used  interchanqeably,  as  nay 
BACKWARD  and  UPWARD.  The  FORWARD  (or  DOWNWARD) 
parameter  causes  retrieval  of  information  about  each 
Input  name  based  on  UTILIZES,  SUBPARTS,  CONSISTS  and 
SUBSETS  statements  (for  STRUCTURE)  or  USED,  USED  TO 
DFRTVE,  USED  TO  UPDATE,  RECEIVED,  UPDATES,  DERIVES, 
and  GENERATES  statements  (for  DATA-FLOW).  The 
BACKWARD  (or  UPWARD)  parameter  causes  retrieval  of 
information  about  each  input  name  based  on  UTILIZED, 
PART,  CONTAINED,  and  SUBSET  statements  (for 
STRUCTURE)  or  USES,  USES  TO  DERIVE,  USES  TO  UPDATE, 
RECFIVFS,  UPDATED,  DERIVED,  and  GENERATED  statements 
(for  DATA  - FLOW) . Since  there  is  no  default,  one  of 
the  above  parameters  must,  be  specified. 


LINKS^inteqer 


Default:  LINKS* 1000 


Output- 
Form  at 


The  LINKS  parameter  specifies  the  maximum  nuiber  of 
links  (connections  between  names)  to  be  followed  in 
producing  the  report.  LINKS  can  take  on  any  inteqer 
value  between  1 and  10C0,  inclusive. 


COLUM  NS  (COLS)  =int.eger 


Default:  COLU1NS=11R 


The  COLUMNS  parameter  specifies  the  number  of  columns 
to  be  used  for  output.  The  maximum  value  allowed  is 
1 IQ. 


ROWS= integer 


Default:  R0WS=39 


The  rows  parameter  specifies  the  number  of  rows  to  ba 
used  for  outDut.  The  maximum  value  allowed  is  39. 

HO?TZONTAL-BOXES(HB)  = integer  Default:  (see  text) 

BORTZONTA L-BOXES  specifies  the  maximum  number  of 
boxes  containing  names  to  be  arranqed  across  the 
Dage.  The  default  value  is  the  largest  possible 
value  for  the  qiven  value  of  COLUMNS,  and  is  compute] 
as  the  greatest,  integer  in  (COLUMNS-4) /17. 

VERTICAL-POXES  (VB) =integer  Default:  (see  text) 

VERTICAL- BOXES  specifies  the  maximum  number  of  boxes 
containing  names  to  be  arranged  down  the  page.  The 
default,  value  is  the  largest  possible  value  for  the 
given  value  of  RUWS,  and  is  computed  as  the  greatest 
integer  in  (ROWS- 2)  /f>. 
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Messages:  If  the  NOPIZONTAL-BOXES  value  used  will  not  fit  in 
the  number  of  COLUMNS  specified,  the  aessage: 

HORIZONTAL-BOXES  TOO  LARGE  FOR  NUMBER  OF  COLUMNS  ON 
PAGE 

will  be  given. 

If  the  VERTICAL-BOXES  value  used  will  not  fit  in  the 
number  of  ROWS  specified,  the  aessage: 

VERTICAL-BOXES  TOO  LARGE  FOR  NUMBER  OF  ROWS  ON  PAGE 

will  be  given. 

If  neither  the  DATA-FLOW  nor  STRUCTURE  paramater  is 
specified,  the  message: 

NEITHER  DATA-FLOW  NOR  STRUCTURE  WAS  SPECIFIED 
will  be  printed. 

Tf  none  Of  FORWARD,  BACKWARD,  UPWARD  and  DOWNWARD  is 
specified,  one  of  the  following  messages  will  be 
printed: 

NEITHER  FORWARD  NOR  BACKWARD  WAS  SPECIFIED 
NEITHER  UPWARD  NOR  DOWNWARD  WAS  SPECIFIED. 

Examples:  EXTENDED- PICTURE  STR  DOWN  N=PROCESS1 

EP  FILE  DF  BACKWARD  LINKS*5 
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Command:  FORMATTED- PROBLEM-STATEMENT  Type:  report  command 

Purpose:  To  produce  the  FORMATTED  PROBLEM  STATEMENT  for  a 

given  name,  or  list  of  names  and/or  to  produce  this 
information  in  the  form  of  PUNCH  data. 

Prototype:  FORMATTFO-PROBLEM-STATEMENT  (PPS)  [parameter]... 

Parameters: 


Input-  FILE  ( P)  [ = f dname  ],  NAME  (N) =user-name  Default:  FILE 

Da  ta 

When  the  FILE  parameter  is  used  and  no  fdname  is 
designated,  the  contents  of  the  default  file1  are 
used  as  input  to  the  command.  This  file  is  the 
default  punch  file  for  NAHE=GEN.  If  an  fdnaie  is 
indicated,  that  file  is  used  as  the  input  file  for 
the  command.  When  a name  is  given  via  the  NAME 
parameter,  the  report  is  produced  only  for  the  name 
specified.  The  format  of  the  input  file  must  be  one 
name  per  line. 

Output-  INDFV,  NOINDEX  Default:  NOINDEX 

Data 

The  INDEX  parameter  specifies  the  production  of  a n 
index  for  the  FPS.  This  index  consists  of  an 
alphabetical  listing  of  all  user  defined  names  used 
in  the  FORMATTED  PROBLEM  STATEMENT  and  the  page(s)  on 
which  they  occur. 

PRINT,  NO  PPINT (NP)  Default:  PRINT 

The  NOPRINT  parameter  specifies  that  no  printed 
output  report  will  be  produced.  The  PRINT  parameter 
specifies  the  production  of  the  FORMATTED  PROBLEM 
STATEMFNT. 


PUNCH  (P)  ;=  fdname],  NOPUNCH  Default:  NOPUNCH 

The  nfJNCH  parameter  specifies  that  PUNCH  data  should 
be  generated  and  written  into  the  designated  PUNCH 
file.  when  the  PUNCH  parameter  is  used  and  no  fdname 
is  designated,  the  data  is  written  into  the  default 
PUNCH  file.1  This  file  is  the  default  PUNCH  file  for 
the  command.  If  an  fdname  is  indicated,  that  file  is 
used  as  the  PUNCH  file.  With  the  NOPUNCH  parameter 
in  effect,  no  action  is  taken  to  generate  PUNCH  data. 

Output-  COMMENT  (COM)  , NOCOMMENT  (NCOH)  Default:  COMMENT 


1 The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  E. 
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Option 

The  COMMENT  option,  when  in  effect,  specifies  the 
inclusion  of  coenents  for  undefined  naaes.  The 
NOCOHHENT  option  suppresses  these  consents. 

DEFINE  (1>EF)  , NODEPINE(NDEP)  Default:  DEFINE 

With  the  DEFINE  option  in  effect,  DEPINE  sections  are 
included  in  the  report.  The  NODPFINE  option 
specifies  that  no  DEFINE  sections  are  included  in  the 
FORMATTFD  PROBLEM  STATEMENT. 

DESG(DG),  NODESG  (NDG)  Default:  DESG 

The  DESG  option,  when  in  effect,  indicates  that 
DESIGNATE  sections  are  provided  for  SYNONYM  oases  in 
the  FORMATTED  PROBLEM  STATEMENT.  The  NODESG  option 
suppresses  the  production  of  such  output. 

EMPTY,  NOFHPTY  Default:  (see  text) 

When  EMPT* Y is  in  effect  (the  default  when  the  PUNCH 
paraneter  is  also  used)  the  PUNCH  file  is  enptied 
before  PUNCH  data  is  written  into  it.  When  NOEHPTY 
is  in  effect  (the  default  when  PUNCH  is  not  used)  no 
action  is  taken  to  enpty  the  PUNCH  file. 

ALL-STATFEENTS  (AS)  , NOALL-STATEMENTS  (NAS) 

Default:  NOALL-ST ATEMENTS 

The  ALL-STATEMENTS  option  specifies  that  all 
statements  will  be  printed  for  each  section  in  the 
formatted  problem  STATEMENT  whether  information  was 
supnl  ied  or  not. 

LINF-  NUMBERS  (LN3)  , NOLINE- NUMBERS  (NLNS) 

Default:  LINE-NUMBERS 

Specifies  whether  or  not  line  nuabers  are  to  be 
produced  in  the  printed  output. 

PRINT  EOF  ( PEOF)  , NO PRI NTEOF  (NPEOP)  Default:  PRINTEOP 

Specifies  whether  an  extra  line  containing  EOF  is  to 
he  produced  at  the  end  of  the  output. 

Z 0 M.PLEMEN  TAR  Y- ST  ATEMENTS  (COMP) 

Default:  CO MPLBMENTARY- 
NOCOMPLEM  ENTARY-STATEMENTS  (NCOMP) 

STATEMENTS 

Specifies  whether  complementary  statements  are  to  be 
produced.  If  the  NOCOMPLEMENTARF-STATEHENTS  option 
is  in  effect,  then  the  number  of  statements  and  lines 
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Output- 

Format 


* RMAPG 


in  the  output  is  the  minimum  which  contains  ill  the 
infomation  in  the  data  base. 

AMARG  (AM)  ^integer  Default:  AHARG® 1 D 

The  AKAF3  parameter  indicates  the  column  at  which  the 
first  name  of  a name  pair  is  to  be  outputted.  An 
example  of  a name  pair  can  be  found  in  the  ATTRIBUTE 
statement  where  the  syntax  requires  an  ATTRIBUTE  naaa 
and  A TTRI  BUTE- VALUE.  AHARG  must  take  on  some  value 
greater  than  SMARG  and  less  than  ENARG. 

BKAR3  (PM)  ^integer  Default:  BNA  RG=  25 

The  BflAPG  parameter  indicates  the  column  at  which  the 
second  name  of  a pair  is  to  be  outputted.  BNARG  must 
take  on  some  value  greater  than  AHARG  and  less  than 
PNHARG-13  . 

CMAFO  (CM)  =integer  Default:  CM A RG  = 1 

The  C MAR3  parameter  specifies  the  number  of  columns 
from  SMARG  the  text  (comment  entry)  for  a comment, 
entry  statement  begins.  CMARG  must  take  on  some 
value  greater  than  0 and  less  than  RMARG-72.1 

HMAPG  (HM)  =integer  Default:  HHA RG=  40 

This  parameter  specifies  the  column  where  ths  user 
defined  name  in  a section  header  statement  ace  to  be 
printed  on  the  output.  HMARG  must  take  on  some  valua 
greater  than  SMARG  and  less  than  RMARG-33.* 

NFW-LINF  (NL)  , NON  E W- LI N E (NNL)  Default:  NO  NEW*  L I NE 

When  tha  NEW-LINE  parameter  is  given,  the  first  name 
of  a name  list  associated  with  a statement  will 
appear  on  the  line  succeeding  the  statement 
identifier  (name  of  the  statement).  The  NON2W-LINE 
parameter  initiates  the  list  on  the  same  line  as  the 
statement  identifier. 

N FW- P AGP  (NPG)  , NONEH-PAGE  (NNPG) 

Default:  NONEH-PAGE 

When  given,  the  NEW- PAGE  parameter  specifies  that 
each  section  of  the  FPS  be  printed  on  a separate 
page.  NONEH-PAGE  signifies  that  the  sections  will 
follow  one  another  on  a page  within  the  page  size 
restrictions.  Tn  any  case,  interrupted  sections  will 
be  continued  on  succeeding  pages. 


has  the  value  IIP  at  most  installations. 
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NMAR3  (NN)  =integer  Default:  NHARG=20 

The  NMAR3  parameter  indicates  the  column  in  which  the 
name  or  first  naae  of  a naae  list  for  any  statement 
will  be  outputted.  NHARG  bus t take  on  some  value 
greater  than  SNARG  and  less  than  RNMARG-30. 

DNE-PEP-LINE(OPL)  f SEVERAL-PER-LINE  (SPL) 

Default:  ONE-PER-LINE 

The  ONE-PER-LINE  option  indicates  that  the  names  in  a 
naae  list  for  any  statement  will  appear  on  succeeding 
lines.  SEVERAL- PER- LINE  option  signifies  that  naaes 
in  a naae  list  will  appear  on  the  saae  line. 

RNMARO  (RN) ^integer  Default:  RNMAR3-70 

Specifies  the  right-hand  aargin  for  naaes  in  a naae 
list  when  the  SEVERAL-PER-LINE  parameter  is  in 
effeot.  RNHARG  aust  take  on  some  vaLue  greater  than 
NAT  (BMAFG,  NBA RG)  *29  and  less  than  RMARG-30.* 


SMARG  (SM)  =inteqer  Default:  5(1  A RG-  5 

The  SNARG  parameter  indicates  the  coluan  in  which  the 
statement  identifier  (name  of  the  statement)  will  be 
started.  SM AFG  must  take  on  some  value  greater  than 
0 and  less  than  MIN (AMARG,  NHARG)  . 

Examples:  PPS  N=FIELD-CHECK-NEW 

FPS  FILE 


1 RMARG  has  the  value  119  at  most  installations. 
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Command:  FREQUENCY  Type:  report  command 

Pumose:  To  produce  the  FREQUENCY  REPORT. 

Prototype:  FREQUENCY (FREQ) 

Parameters: 

None 

Examples:  FREQ 


i 


i ; 

i 

. 

•• 

I 


* 

i i 
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HELP 


To  provide  the  on-line  user  with  a list  of  possible 
commands  for  URA  or  infornation  about  the  paraseters 
for  a particular  ORA  command. 


HELP  [parameter]... 


Command-name  Default:  (see  text) 

If  no  command-name  is  given,  a list  of  curreatly 
available  ORA  commands  is  given.  If  a command-name 
is  given,  then  the  parameters  for  that  commaad  are 
oresented.  Abbreviations  for  the  command- name  are 
also  acceptable. 

SHORT,  LONG  Default:  SHORT 

If  SHOPT  is  given,  only  the  parameters  for  the  given 
command  are  printed.  If  LONG  is  given,  explanations 
of  the  various  parameters  are  also  printed. 


HELP  EPS  LONG 
HELP  CONTENTS 


A 


► 


I 


t 

i 


■j 

f 

l 

i 

j 

t 


; 

| 

< 

| 
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Command: 

Purpose; 

Prototype; 

Para  meters 

Inpu  t- 
Data 


Inpu  <•- 
Cont  rol 


Outnut- 

Data 


Examples: 


I N PUT-PSL  Type:  modifier  command 

To  add  information  t.o  the  UFA  data  base  to  expand  or 
modify  the  problem  stateaent.  A permanent  record  of 
the  change  can  be  generated  in  the  form  of  the  AS-IS 
SOURCE  LISTING  and  URA  CROSS  REFERENCE. 

INPUT-PSL  (IP)  [parameter]... 


INPUT  (I)  - f dnaae 


Default:  INPUT=tecainal 


when  INPUT  is  specified,  the  contents  of  the 
designated  fdname  are  used  as  input  to  the  command. 
This  input  must  be  in  the  format  of  legal  URL 
statements  as  specified  by  Part  II,  URL  User's 
Manual.  The  EOF  statement  terminates  input.  If  the 
INPUT  parameter  is  not  specified,  input  is  read  from 
the  terminal  so  that  the  URL  statements  can  be 
entered  interactively. 

DBREF  (D)  , NODBREF  (ND)  Default:  DBREF 

The  DBREF  parameter  allows  the  referencing  of  the 
data  base  by  URA  in  its  syntax  and  semantic  analysis. 
When  given,  NODBREF  allows  the  analyzer  to  only 
perform  a syntax  check  of  the  input. 

UPDATE(U)  , NOUPDATE  (HU)  Default:  NOUPDATE 

With  the  UPDATE  parameter  given,  the  input  will 
update  the  URA  data  base.  NOUPDATE  indicates  that 
the  data  base  is  not  to  be  changed. 

SOUPCE(S)  , NOSOURCE  (NS)  Default:  SOURCE 

When  the  SOURCF  parameter  is  in  effect,  AS-IS  SOURCE 
L I STI NG  of  the  input  URL  is  produced.  When  the 
NOSOURCE  parameter  is  given,  the  listing  is  not 
produced. 

XREF(X),  NOXRFF  (NX)  Default:  NOX  REF 

XPEF  specifies  that  a UFA  CROSS  REFERENCE  is  to  be 
generated  for  the  AS-IS  SOURCE  LISTING.  This 
consists  of  a list  of  all  user  defined  names  from  the 
input  file  and  the  line  numbers  on  which  they  occur 
in  the  AS-IS  SOURCE  LISTING. 

I NPUT-PSL  XREF  UPDATE 
IP  U 
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Coaaand:  KBTC  Type:  report  coaaand 

Purpose:  To  produce  a KWic  INDEX  for  a list  of  naaes. 

Prototype:  KWIC  ( paraaeter].  . . 

Para  aeters: 

* TLB  ( F)  ‘ = f dnaae  ] Default:  FILE 


When  the  FILE  paraaeter  is  used  and  no  fdnaae  is 
designated,  the  contents  of  the  default  file1  are 
used  as  input  to  the  coamand.  This  file  is  the 
default  PDNCH  file  for  NAHB-GEN.  If  an  fdnaae  is 
indicated,  that  file  is  used  as  the  input  file  for 
the  coaand.  <rhe  foreat  of  the  input  file  aust  be  ona 
naae  per  line. 

DI  F*i  nteger  Default:  DIF*23 

DTW  is  the  nuaber  of  spaces  allowed  between  the 
keyword  and  the  rest  of  the  naae  as  it  appears  in  the 
output.  DIF  aust  take  on  soae  value  greater  than  1 
and  less  than  *3. 

KBIC  DIF* 1 0 

K BTC 


1 Th e naae  of  the  default  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  E. 


v 


Input- 

Data 


Du*  put- 
•‘oraat 


Pxaaples: 


HM  80  /Nul  tics /URA  User's  Manual  243 


Command:  N A MF- GENE RATION  Type:  repact  command 

Purpose:  To  produce  the  NAME-GENERATION  report  and/or  retrieva 

certain  naaes  to  be  put  in  a PUNCH  file  and  used  as 
input  to  other  coaaands. 

Prototype:  N A NF-GENE RATION (NG)  [ parameter  ]. . . 

Parameters: 

Output-  PRINT,  NO  PRINT  (VP)  Default:  PRINT 

Data 

The  PRINT  parameter  initiates  the  production  of  the 
Name  Generation  Report:  VOPRINT  suppresses  printing 
of  the  report. 

PUNCH  (P)  [ =fdname  ],  NOPUNCH  Default:  PUNC3 

The  PUNCH  parameter  specifies  that  PUNCH  data  should 
be  generated  and  written  into  the  designated  PUNCH 
file.  When  the  PUNCH  parameter  is  used  and  no  fdnama 
is  designated,  the  data  is  written  into  the  default 
PUNCH  file.1  This  file  is  used  as  the  PUNCH  file, 
with  the  NOPUNCH  paraaeter  in  effect,  no  action  is 
taken  to  generate  PUNCH  data. 

Output-  EMPTY,  NOEHPTY  Default:  (see  text) 

Option 

When  EMPTY  is  in  effect  (the  default  when  the  PUNCH 
parameter  is  also  used)  the  PUNCH  file  is  emptied 
before  the  list  of  names  is  written  into  it.  When 
NOE"PTY  is  in  effect  (the  default  when  PUNCH  is  not  » i 

used)  no  action  is  taken  to  empty  the  PUNCH  file. 

When  PUNCH  and  NDEMPTY  are  specified  together,  the 
punched  output  appears  at  the  end  of  the  list  of  f ' 

names  already  in  the  file. 

SELECTIONS  (S)  = • (boolean  expression')  , 

INPUT  (I)  : =fdname]  Default:  no  default 

The  SELECTION  paraaeter  is  used  to  retrieve  names  of 
particular  name  types  or  which  meet  various  selection 
criterion.  The  contents  of  the  boolean  expression 
specifies  the  types  of  names  to  be  retrieved  and  how 
they  are  to  be  selected. 

If  the  boolean  expression  (without  primes)  is  stored 
in  a file,  the  expression  may  be  used  to  selact  names 
when  the  file  is  specified  by  the  INPUT  paraaeter. 


* ’hp  name  of  the  dafault  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  E. 
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A boolean  expression  consists  of  the  follovinq 
oblects: 


1.  Ope  rand  s 

An  explanation  of  each  operand  is  given  belov. 
NAME-TYPE 

The  following  naae  types  say  be  used  as  operands: 


A * TRIP  OTE 

ATTFT  BOTE- V ALU  E 

CLASSIFICATION 

CONDITION 

ELEMENT 

ENTITY 

EVENT 

OR  OOP 

IN  POT 


INTERFACE 

INTERVAL 

KEYWORD 

MAILBOX 

MEMO 

OOTPOT 

PROBLEM- DEFINE P 

PROCESS 

PROCESSOR 


REOOSRCE 

RESOORCE-OS AGE- PARAMETER 

SECORITY 

SET 

SOURCE 

SUBSETTING- CRITERION 

SYSTEM-PABAHErER 

ONDEFINED 

UNIT 


ALL 

When  the  ALL  operand  is  specified,  the  naaes  of  all  naae 
types  except  SYNONYM  and  ONDEFINED  will  be  presents!. 


TOTAL 

When  the  TOTAL  operand  is  specified,  every  naae  in  the  data 
base  will  be  presented. 


ATTR=attr-name[  , value] 

When  the  ATTF  operand  is  specified,  those  naaes  with  the 
given  user-naae  as  an  ATTRIBUTE  are  selected  to  be  part  of 
the  output.  The  user-naae  must  be  a naae  defined  as  an 
ATTRIBUTE  in  the  data  base. 

If  an  A TTRI RnTE- VALUE  is  specified  as  part  of  the 
user-naae,  then  only  those  naaes  with  the  given  user-naae 
as  an  ATTRI BOTE-VALUE,  for  the  ATTRIBUTE  designate!  by  the 
ATTR  paraaeter,  are  selected  to  be  part  of  the  output.  The 
user-naae  aust  be  an  ATTRIBUTE- VALUE  naae  in  the  data  bse. 


SURPARTS-OF (SO)  *oser-naae[ , level  ] 

All  naa?s  which  belono  to  the  SUBPARTS  structure  for  a 
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qiven  name  (as  would  be  retrieved  for  the  STRUCTURE  report) 
can  he  retrieved  by  specifying: 

SO  BP APTS-OF»nane 

where  the  nane  is  an  INPUT,  OUTPUT,  PROCESS  or  INTERFACE 
name  which  has  SUBPAPTS  information  defined  for  it.  The 
number  of  levels  to  go  down  and  retrieve  names  to  present 
in  the  report  is  specified  by  the  SUBLEVEL  parameter  or  by 
attaching  a command  a level  number  after  the  user-name  with 
the  SUB P ART  S-UP  parameter. 

Tf  SUBLEVEL  =C,  then  all  levels  of  names  are  presented.  If 
SURLEVEL=1,  then  only  those  names  which  are  PART  OF  the 
SUPPAPTS-OP  name  are  presented.  The  following  picture  may 
clarify  the  association  between  the  value  of  SUBLEVEL  and 
the  names  presented. 


SUBPARTS-OF  name 


_ S2 

1 

S3  54 

1 

SUBLEVEL3 1 

ss 

sl 

1 

Sl 

SUBLEVEL3  2 

/ \ 

/ \ 

SB  S 9 

SIC  S11 

SUBLEVEL3 3 

A 

A 1 

' \ 

/ v 1 

N / v I 

/ \ / \ SUBLEVEL=0 


\ 


Generation  of  *-he  report  with  SUBPARTS-0P=S1  and  SUBLEVEL*3 
would  present  S2,  S3,  S4 , S5,  S6,  S7,  SB,  S9,  510  and  S11 
in  the  report.  Generation  of  the  report  with 
SUB PARTS-OF =S1  and  SUBLEVEL=1  would  present  the  naaes  S2, 

S3  and  S4. 


SYNONYMS 

When  the  SYNONYMS  operand  is  specified,  all  SYNONYMS  are 
presented  for  each  name  retrieved  in  the  report  in  addition 
to  the  basic  forn  of  the  nane.  If  only  the  SYNONYMS  are 
desired,  the  basic  names  may  he  suppressed  by  specifying 
the  NOB  ASIC  and  SYNONYM  parameters.  With  standard  defaults 
in  effect,  the  BASIC  and  NOSYNONYM  parameters  are  ased. 


KEY *user-r.a  me 

When  the  KFY  onerand  is  specified,  those  names  with  the 
given  user-name  as  a KEYWORD  are  selected  to  be  part  of  tha 
output.  The  user-name  must  be  a nane  defined  as  a KEYWORD 
in  the  data  base. 
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PD*user- nas me 

whan  the  PD  operand  is  specified  those  nases  with  the  given 
user-nase  as  a KEYWORD  are  selected  to  be  part  of  the 
output.  The  user-nase  aust  be  a naae  defined  as  a KEYWORD 
in  the  data  base. 


Son  PCE*  user  -naie 

When  the  SOMPCE  operand  is  specified,  those  nases  with 
given  user-nase  as  a SOORCF  will  be  included  in  the  output. 
The  user-nase  sust  be  defined  as  a SOORCE  in  the  data  base. 


SECURITY  =user-n  ase 

When  the  SECURITY  operand  is  specified,  those  nases  with 
given  user-nase  as  a SECURITY  will  be  included.  The  user- 
nase  aust  be  defined  as  SECURITY  name  in  the  data  base. 


USAGE*™,  IDPNTIFTER 

When  the  USAGE  operand  is  specified,  those  nanes  which  hava 
user-nase  as  IDENTIFIERS  in  the  data  base  are  selected  to 
be  part  of  t.he  output.  The  syntax  of  the  Language  only 
allows  ELEMENT,  GROUP  and  ONDEPINED  naaes  to  be 
IDENTIFIERS . 


2.  2££Iii2£s 

An  explanation  of  each  operator  is  given  below. 


NOT,  - 

The  NOT  operator  placed  before  an  operand  specifies  that 
the  naaes  associated  with  that  operand  will  not  be 
retrieved.  For  exaaple,  a boolean  expression  of  the  fora 
NOT  PROCESS  m?ans  that  all  nanes  in  the  data  base  axcept 
for  PROCESS  nases  will  be  retrieved. 


AND  ,R  ,* 

The  and  operator  specifies  that  any  naae  retrieved  froa  tha 
data  base  sust  aeet  the  criterion  designated  before  and 
after  the  AND  operator.  For  exaaple,  a boolean  expression 
of  the  fora  PROCESS  AND  KEY*level-1  aeans  that  any  nane 
retrieved  sust  be  a PROCESS  naae  as  well  as  have  the 
KEYWORD  "level- 1"  attached  to  it. 
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OR,  1 ,* 

The  OR  operator  specifies  that  any  nase  retrieved  froa  the 
data  base  aust  either  aeet  the  criterion  designate!  before 
the  or  operator,  or  after  the  operator,  or  both.  For 
example,  a boolean  expression  of  the  fora  PROCESS  DR 
KEY*level-1  aeans  that  any  naae  retrieved  aust  be  either  a 
PROCESS  name,  or  have  the  KEYWORD  " level- 1*,  or  be  both  a 
PROCESS  and  have  the  KEYWORD  "level-1". 


3.  Other  Notations 

f 1 

Braces  nay  be  used  to  group  operands  and  operators  in  a 
boolean  expression. 

The  following  rules  apply  to  the  foraation  of  boolean 
expressions  to  be  used  with  the  SELECTION  parameter  of  the 
NAME-OEN  coanand. 

The  following  notation  is  used  to  define  a boolean 
expression: 

exp  - boolean  expression 
opd  - operand 
opr  - operator 

1)  A boolean  expression  (exp)  can  only  be  in  one  of  the 
fol  lowi  ng  f ores  : 

a)  opd 

b)  » exp 

c)  (exp) 

d)  exp  opr  exp 


2)  A boolean  operator  (opr)  nust  be  one  of  the  following 
(eguivnlent  operators  are  listed  in  parentheses)  : 

a)  8 (AND,*) 

b)  1 (DP,*) 

3)  A boolean  operand  (opd)  aust  be  one  of  the  allowable 
options  for  ths  SELECTION  paraneter  as  listed  below: 

a)  name-type 

b)  KEY»  user-name 

c)  PD=aser-name 

d)  SOURCE»user-  naae 


t 


The  fora  exp"  can  also  be  written 
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e)  SECU  RITY  *use  r-naae 

f)  USAGF«user-naae 

g)  AT?R»us»r-naae 

h)  ATTR ■ use  c-n* ae, user- naae 

i)  ATTR»usnr-na ae, inteqec 

ij  SUBPARTS-OF  (SO)  »user-naae 

k)  SUBPARTS-or  (SO) ■user-nase, ALL 

l)  SUBpARTS -OP (SO)  «user-naae,  integer 

a)  SUBLPVFt.  (SL)  » (ALLI  integer) 

A naae-tyoe  option  can  be  any  of  the  following: 


ATTRIBUTE  (A  TTP) 
ATTPIBUTB-V  ALUF  ( ATTV) 
CLASSIFICATION  (CLS) 
CONDITION  (COVT)) 
ELTHENT  (ELB) 

ENTITY (ENT) 

FVENT(EV) 

GROUP  (GR) 

INPnT(INP) 

INTERFACE  (INTP) 
INTERVAL  (TNT) 

KEY  WORD  (K*Y) 

MAILBOX  (BOX) 

MEMO 

OUTPUT  (OUT) 

PRO  BLEB -DFFINFR  (PD) 
PROCESS  (PPOC) 


PROCESSOR (PRCR, PR03  R) 
REAL-WORLD-  ENTITY  (RNE) 
RELATION  (RLN) 

R E SOURCE  (RSC) 

RESOnRCB-OS  AGE-PARAMETER  (R7  P) 
SECURITY  (SEC) 

SET 

SOURCE  (SRC) 

SUBSETTING- CRITERION (SSCN) 

SYSTEM-PARAMETER  (SYSP) 

UNDEFINED 

UNIT 

ALL 

TOTAL 

BASIC 

SYNONYM  (SYN) 


The  rules  which  aust  be  followed  in  specifying  these 
boolean  expressions  are  as  follows: 

1)  Any  number  of  blanks  in  a boolean  expression  nay  occur: 

a)  on  either  side  of  an  operand 

b)  before  and  after  the  syabol 

c)  before  and  after  the  syabols  and  w)  " 

d)  on  either  side  of  an  operator 

2)  No  blanks  may  occur  within  an  operator  and  no 
substit  utf»n,  other  than  the  specified  syabols  are  allowed 
to  represent,  operators. 


7)  No  blanks  aay  occur  within  an  operand  and  no  operands 
other  than  the  specified  operands  aay  be  used. 

U)  Assuae  that  AND  has  precedence  over  OR  when  parentheses 
are  not  qiven.  For  exaaple,  the  expression  ELEMENT  AND 
GROUP  DR  KET-low  is  interpreted  as  (ELEMENT  AND  GROUP)  OR 
KEY  «low  rather  than  ELEMENT  AND  (GROUP  OR  KEY>low). 

5)  A is  aaaused  to  belong  to  the  issediately  following 
operand  unless  specified  otherwise,  for  exaaple,  the 
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expression  -»  PROCESS  OR  ELEMENT  would  be  interpretted  as  {-» 
FPOCESS)  OR  ELEMENT  rather  than  -«  { PROCESS  OR  ELEMENT). 


6)  » boolean  expression  nay  be  continued  over 
when  the  last  character  on  the  line  is  a dash 
appears  in  the  ordinary  command  streaa.  When 
specified,  the  boolean  expression  aust  appear 
format,  with  ns  operands  broken  between  lines 
for  continuation. 


several  lines 
(-) , when  it 
input*  is 

in  card  image 
and  no  dashes 


The  following  boolean  expressions  are  illegal  for  the 
NAME-GEN  command: 


1)  PROCESS  OR  ( GROUP  K EY WORD=level - 1) 

No  operator  between  operands  GROUP  and  KEYWORD 
The  following  boolean  expressions  are  legal: 

1)  ELEMENT  OP  GROUP  OR  ENTITY 

2)  PROCESS  AND  KEYW0PD=S1  OR  KEYWORD=level- 1 

1)  { GROUP  | ELEMENT  ) AND  ATTR=type, character 


Output- 

por mat  ORDER  = (9YTYPE) ALPHA )attr-name) . . . 

Default:  ORDER*  BYTYPE 

The  ORDER  parameter  specifies  how  the  names  retrieved 
are  to  be  ordered  (in  the  PUNCH  file  and  the  report). 

When  ORDER -ALPHA,  all  names  retrieved  are  presented 
in  alphabetical  order  by  name.  When  ORDBR=BY TYPE, 
all  names  retrieved  are  grouped  by  the  name  types 
associated  with  them.  The  name  types  are  ordered 
alphabetically  as  are  the  names  within  each  name  type 
group,  when  ORDEF=attr-name  or 

ORDER*attr-name-synonym,  all  names  retrieved  are 
presented  in  alphabetical  order  of  the  values  they 
have  for  the  specified  ATTRIBUTE  name.  Names  which 
do  not  have  the  specified  ATTRIBUTE  are  placed  at  the 
beginning  of  the  list  of  names. 

In  addition  to  the  three  different  orderings  that  may 
be  specified,  an  ordering  list  may  be  given  which 
allows  up  to  five  levels  of  ordering  on  the  retrieved 
names.  Dnly  the  BYTYPF  option  and  ATTRIBUTE  names 
may  appear  in  tha  ordering  list.  (The  ALPHA  option 
mav  not.)  The  BYTYPE  option  may  only  appear  once  in 
the  list.  ;All  options  in  the  list,  must  be  separated 
by  commas.  ; No  blanks  may  appear  in  the  list.  The 
names  are  ordered  first  on  the  first  option  in  the 
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ordering  list;  within  that  orderinq,  on  the  second 
option  in  the  ordering  list,  etc.  Soae  axaaples  of 
usinq  the  orderlnq  list  are: 

ORDPR-BYTYPE, length,  type 
ORDER* level, BYTYPE 

Examples 

NG  S* 'PROCESS  AND  KEY»level-2' 

NG  S»'fNDT  PROCESS)  * KEY*level-2' 

NO  s» * ATTP-occurrence,  unscheduled' 

AND  SO  *'  security-control-input' 

NG  S* • SD*security-control-input , 1 • 

ORDER *BYT  YPE , occurrences 
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Command:  NAME-LIST  Type:  report  command 

Purpose:  To  produce  the  NAME  LIST  report. 

Prototype:  N AMF-LTST  (NL)  f pa  ra  meter  ]. . . 

Para  meters: 

Out  out- 

ORDER3  fALPHA|  BYTYPE)  Default:  ORDER*  AL  PH  A 

Format 

If  OR  DER 3 ALPH A is  specified,  the  list  is  ordared  by 
the  URA  name  of  tho  ob-Ject,  if  ORDER* BYTY PE  Is 
specified,  the  order  is  alphabetical  by  name  type, 
with  objects  of  the  same  type  being  ordered  by  name. 

®‘xamnles:  NAME-LIST 

NL  ORDPR-BYTYPF 
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Coaaand:  PICTURE  Type:  report  coasand 

Puroose;  *o  produce  t.he  PICTURE  report. 

Prototype:  PTCTURF(PIC)  f parameter  ]. . . 

Parameters: 

Tnput-  F I L5  ( F)  * * f dnaae  ],  N A ME  ( N)  »use  r-naa  e Default:  FILE 
Data 

When  the  FILE  paraaeter  is  used  and  no  fdnaat  is 
desiqnated,  the  contents  of  the  default  file*  are 
used  as  Input  to  the  coaaand.  This  file  is  the 
default  PUNCH  file  for  NAME-GEN.  If  an  fdnaie  is 
indicate!,  that  file  is  used  as  the  input  file  for 
the  coaaand.  when  a naae  is  qiven  via  the  NAME 
oaraaeter,  the  report  is  produced  only  for  that  naae. 
In  any  case,  the  nines  used  as  input  to  this  coaaand 
■ust  he  INTERFACE,  PROCESS,  SET,  INPUT,  DOTPUT, 
ENTITY,  IPOUP  and/or  ELEMENT  naaes.  The  foreat  of 
the  input  file  aust  be  one  naae  per  line. 

output-  IVD^X,  NOINDEX  Default:  N3INDSX 

Data 

The  INDEX  paraaeter  specifies  the  production  of  an 
index  for  the  PICTURE  report.  This  index  consists  of 
all  user  defined  naaes  used  in  the  report,  in 
a l nh i bet ical  order  and  the  paqes  on  which  thay  appear 
in  the  report. 

Output-  0 A~A(  0)  , NODATA(ND)  Default:  DATA 

Opt  i on 

With  the  DA'tA  oaraaeter  in  effect,  inforaation 
applicable  and  available  for  the  qivan  naae,  oc  list 
of  naaes  other  than  structure  or  flow  data  is  priatel 
on  ♦he  output.  NODATA  inhibits  such  action. 

FLOW,  NUF LOW  Default:  FLOW 

This  Dimeter  presents  flow  inforaation  in  the 
PICTURE  report.  It  presents  RECEIVES  and  GENERATES 
information  between  INPUTS  and  OUTPUTS  with  PROCESSES 
and  INTERFACES.  It  also  presents  USES  and  DERIVES 
inforaation  between  PROCESSES  and  data  (such  as  SETS, 
ENTITIES,  GROUPS  and  ELEMENTS). 

STRUCTURE  (STR)  , N OSTRUCTURE  (N  STR)  Default.: 

STRUCTURE 


* The  naae  of  the  .default  file  is  installation  dependent  and 
consequently  is  qiven  in  Anpendix  E. 
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Pxa»ples: 


When  the  STRUCTURE  parameter  is  in  effect,  the 
Information  available  in  the  SUBPART3,  COHSISTS 
and/or  SUBSETS  statements  and  their  compleaea ta ry 
statements  for  the  input  name  (s)  appears  in  the 
report . 

• PICTURE  R»PAYCAIC-UPDATING 

PIC  N * PA Y ROLL- PRD CES SING  NODATA  NOPLON 
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Command:  PRINT-ATTRIBUTE-VALUES  Type:  report  command 

Puroose:  To  produce  the  ATTRIBUTE  REPORT. 

Prototype:  PRINT-ATTR  IBUTF-V  ALOES  (PAV)  [ para  aeter  ). . . 

Para  eeters: 

Input-  PILE(P)[*f  dname  J,  NAHE(N)  *user-name  Pafault:  PILE 
Data 

When  th»  FILE  parameter  is  used  and  no  fdname  is 
designated,  the  contents  of  the  default  file*  are 
used  as  input  to  the  command.  This  file  is  the 
default  PUNCH  file  for  NAHE-GEN.  If  an  fdnaie  ii, 
Indicated,  that  file  is  used  as  the  input  file  for 
the  comnd,  The  input  file  focsat  aust  he  jne 
ATTRI 3HTF  name  per  line.  When  a naae  is  specified  hy 
the  NAME  parameter,  the  report  is  generated  for  that 
name  only.  In  any  case,  only  ATTRIBUTE  nsies  say  he 
used  as  input  to  this  command. 

Fiasples:  P R INT-ATTP IBUTE- V ALLIES  FILE 

PAV  N*TYPF 


1 ’’’he  nase  of  the  default  file  is  installation  dependent  and 
consequently  is  given  in  Appendii  E. 
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Command:  PROCESS-CHAIN  Type:  report  command 

Purpose:  To  produce  the  PROCESS  CHAIN  report. 

Prototype:  PROCESS-CHAIN  (PC)  [ para meter  ] . . . 

Para  meters: 

Input-  ®ILE  ( F)  f * f dname  1,  N AN  E (N)  =user-name  Default:  PILE 

Data 

When  the  FILE  parameter  is  used  and  no  fdnaae  is 
designated,  the  contents  of  the  default  file1  are 
used  as  input  to  the  coaaand.  This  file  is  the 
default  PUNCH  file  for  NAME-GEN.  If  an  fdnaie  is 
given,  that  file  is  used  as  the  input  file  for  the 
command.  The  format  for  the  input  file  last  be  one 
name  per  line.  When  a name  is  given  via  the  NAME 
Darameter,  the  report  is  produced  only  for  that  name. 
Regardless  of  whether  FILE  or  NAME  is  specified,  all 
names  used  as  input  to  this  command  must  be  EVENT  or 
PROCESS  names. 

Output-  INDEX,  NOT  NDEX  Default:  NDINDEX 

Data 

The  INDEX  parameter  specifies  the  production  of  an 
index  for  the  PROCESS  CHAIN  report.  This  index 
consists  of  all  user-defined  names  used  in  the 
report,  in  alphabetical  order,  along  with  the  pages 
on  which  they  appear  in  the  report. 

Output-  LTNKS=integer  Default:  LINKS=1000 

0 pt.ion 

the  LINKS  parameter  specifies  the  maximum  number  of 
Lints  (connections  between  names)  to  be  followed  in 
Droducing  the  report.  LINKS  can  take  on  any  integer 
value  between  1 and  1000,  inclusive. 

Output-  COLUM  NS  (COLS)  =integer  Default:  C0LUNSS=119 

Eoraat 

The  COLUMNS  parameter  specifies  the  number  of  columns 
to  be  used  for  output.  The  maximum  value  allowed  is 
1 19. 

ROWS=integer  Default:  R3WS=39 

The  ROWS  parameter  specifies  the  number  of  rows  to  ba 
used  for  output.  The  maximum  value  allowed  is  39. 

HORIZONTA L-BOXES (HB) =integer  Default:  (see  text) 


• The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  E. 
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NORIZONTA  L-BOXES  specifies  the  maximum  nuiber  of 
boxes  containing  names  to  be  arranqed  across  the 
page,  Tie  default  value  is  the  largest  possible 
value  foe  the  given  value  of  COLUMNS,  and  is  compute! 
as  the  greatest  integer  in  (COLUMNS-4) /17. 

VERTICAL- BOXES  (VB) =inteqer  Default:  (see  text) 

VERTICAL- BOXES  specifies  the  maximum  number  of  boxes 
containing  names  to  be  arranged  down  the  page.  The 
default  values  is  the  largest  possible  value  for  the 
given  value  of  ROWS,  and  is  computed  as  the  greatest 
integer  in  (ROWS-2)  /6. 

Mess  aqes : If  the  HORIZONTAL-BOXES  value  used  will  not  fit  in 
the  number  of  COLUMNS  specified,  the  aessaqe: 

HORIZONTAL-BOXES  TOO  LARGE  POR  NUMBER  OF  COLUMNS  ON 
PAG® 


vill  be  given. 

If  the  VEPTTCAL- BOXES  value  used  vill  not  fit  in  the 
number  of  ROWS  specified,  the  aessaqe: 

VERTICAL- BOXES  TOO  LARGE  FOR  NUMBER  OF  ROWS  3N  PAGE 

vill  be  given. 

pxaa  pies : PROCESS-CHAIN  N = EVENT1 
PC  PILE  LINKS=4  INDEX 
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Command:  PROCE SS-I NPUT-OUTPUT  Type:  report  command 

Purpose:  To  produce  the  PROCESS  INPUT/OUTPUT  report. 

Prototype:  PROCESS- I NPUT-OUTPUT  (PR  10)  [parameter]... 

Parameters: 

Input-  p ILE  (F)  *[  f dnaae ],  NAME(N)  =user-name  Default:  KILE 
Data 

When  the  FILE  parameter  is  used  and  no  fdnaae  is 
designated,  the  contents  of  the  default  file1  are 
used  as  input  to  the  command.  This  file  is  the 
default  PUNCH  file  for  NAME-GEN.  If  an  fdnaie  is 
indicated,  that  file  is  used  as  the  input  file  for 
the  command  and  the  report  is  produced  usinq  all  the 
names  in  the  file.  When  a single  name  is  specified 
by  the  NAME  parameter,  the  report  is  produced  for 
that  name  alone.  Either  FILE  or  NAME  can  be  used  but 
not  both.  In  any  case,  all  the  names  used  as  input 
to  this  command  must  be  PROCESS  names.  The  input 
file  format  is  one  PROCESS  name  per  line. 

Output-  INDEX,  NOT  NDEX  Default:  NOINDEX 

Data 

when  given,  the  INDEX  parameter  specifies  the 
production  of  an  index  into  the  report.  The  index 
consists  of  all  input  and  output  names  in  the  report, 
in  alphabetical  order  and  the  page  (s)  on  which  they 
occur  in  the  report. 

PRINT,  NOPRINT(NP)  Default:  PRINT 

The  NOPPINT  paraieter  specifies  that  no  printed 
output  report  will  be  produced.  The  PRINT  parameter 
specifies  the  production  of  the  PROCESS  INPUT/OUTPUT 
r epor  t . 

Output-  DESCR  IPTION  (DFSC)  , NODESCRI PT  ION  (N  DBS  C) 

Option  Default:  DESCRIPTION 


When  the  DESCRIPTION  parameter  is  in  effect,  the 
comment-entry  associated  with  the  DESCRIPTION 
statement,  for  all  PROCESS  used  as  input,  is 
retrieved  and  printed  on  the  report.  NODESCRIPTION 
specifies  that  this  information  is  not  to  be 
retrieved . 


* The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  E. 
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PROCEDURE  ( PRCD)  , NOP ROCEDURE  ( NPRCD) 

Default : NOPROCSDURE 

When  the  PROCEDURE  parameter  is  specified,  the 
comment  entry  associated  with  the  PROCEDURE 
statement,  for  each  PROCESS  naae  used  as  input,  is 
retrieved  and  printed  on  the  report.  With  the 
NOPROCEDUPE  parameter  in  effect,  this  information  is 
not  retrieved. 

I N PM1*  (I  N P ) , NOINPUT  (NTNP)  Default:  INPUT 

/ When  the  INPUT  parameter  is  i n effect,  all  the  naaes 
of  objects  used  as  input  to  each  PROCESS  (i.a.,  naaes 
associated  with  the  RECEIVES  and  USES  statements)  ara 
retrieved  and  printed  on  the  report.  The  NOINPUT 
parameter  specifies  that  this  inforaation  is  not  to 
be  retrieved, 

OUTPUT  (OUT),  NOOUTPUT  (NOUT)  Default:  OUTPUT 

wh«n  thQ  OUTPUT  parameter  is  in  effect,  all  the  naae3 
of  objects  designated  as  output  from  each  PROCESS 
(i.e.  , names  associated  with  the  GENERATES,  DERIVES, 
and  UPDATES  statements)  are  retrieved  and  printed  on 
* he  report.  The  NOOUTPUT  parameter  specifies  that 
this  information  is  not  to  be  retrieved. 

Output-  NEW-PAC.E(NPG)  , NONEW-PAGE(NNNPG) 

Format  Default:  NONKW-PAOE 

When  given,  the  NEJ-PAOF  parameter  specifies  that 
each  section  of  the  PROCESS  IN  PUT /OUTPUT  report  be 
printed  on  a separate  page.  NONEW-PAGE  signifies 
that  the  sections  will  follow  one  another  on  a ,vaqa 
within  the  paqe  sire  restrictions.  In  any  case, 
interrupted  sections  will  bo  continued  on  succeeding 
pa  ges . 

Examples:  PRTO  N=P  A Y ROLl-PR  OCESSI NG 

PRTO  ? NDFSC  NPG  PRCP 
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Command:  PUNCH-COMMENT- ENTRY  Type:  report  command 

Purpose:  To  produce  the  PUNCH ED- COMMENT-ENTRIES  report  and/or 

punch  the  specified  comment  entries  into  a PUNCH 
file. 


Prototype:  PUNCH-CDM  M ENT-FVTRY  (PCOH)  [parameter]... 
Pa  ra  meter : 


Input-  PILE  ( F)  [=  fdname  ],  NAME(N)  =user-name 
Data  Default:  FT  LF 

When  the  FILE  parameter  is  used  and  no  fdname  is 
designated,  the  contents  of  the  default  file*  are 
used  as  input,  to  the  command.  This  file  is  the 
default  PUNCH  file  for  NAME-GEN.  If  an  fdnaae  is 
indicated,  that  file  is  used  as  the  input  file  for 
the  command.  when  a name  is  specified  by  the  NAME 
narameter,  the  output  is  produced  for  that  name 
alona.  The  format  of  the  input  file  must  be  one  name 
per  line. 

Output-  PRINT,  NDPRINT  (NP)  Default:  PRINT 

Da'-a 

The  print  parameter  initiates  the  production  of 
printed  output  for  the  report.  When  the  NOPRINT 
parameter  is  given,  the  PUNCH  COMMENT  ENTRIES  report 
is  not  produced. 

PUNCH  fP)  ' =fdname],  NPPUNCH  Default:  PUNCH 


ThQ  PUNCH  parameter  specifies  that  PUNCH  data  should 
be  generated  and  written  into  the  designated  pnNCH 
file.  when  the  PUNCH  parameter  is  used  and  10  fdname 
is  designated,  the  data  is  written  into  the  default. 
PUNCH  file,*  This  file  is  the  default  PUNCH  file  for 
the  command.  If  an  fdname  is  indicated,  that  file  is 
used  as  the  PUNCH  file.  With  the  NOPUNCH  parameter 
in  effect,  no  action  is  taken  to  generate  PUNCH  data. 


Output-  EMPTY,  NOFMPTY  Default:  (see  text) 

0 pt ion 

When  EMPrY  is  in  effect,  (the  default  when  the  PUNCH 
parameter  is  also  used)  the  PUNCH  file  is  emptied 
hefore  PUNCH  data  is  written  into  it.  When  NOEMPTY 
is  in  effect  (the  default  when  PUNCH  is  not  used)  no 
action  is  taken  to  empty  the  PUNCH  file. 


The  comment  entries  associated  with  the  following 


* The  name  of  the  iefault  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  E. 
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types  of  comment  entry  statements  are  retrieved  when 
qiven  as  parameters. 


DR? IV ATI ON (DER) , NODERTVATION (NDEP) 
DESCRIPTION ( DESC ) , NODESCRI  PTION  (NDESC) 
PALSS-MHTI.S  (FW)  , NOE  A LSfF-HHI  LE  (NPN) 

PROC  EDM  RE  (PR  CD)  , NOP ROCEDUPE (N RRCD) 

TPUE - WHI LE (T  W)  , NOTRUE-WHILE  (NTW) 
VOLATILITY  (VOL)  , NOVOLATILITY  (N  VOL) 


esiaaUi 

NODERIVATION 
NODESCRIPTION 
NOFALSE-WHILB 
NOPROCFDU  RE 
NOTROE-NHILE 
NOVOLATI LITY 


VOLATILITY-1  EMBER  (VOL N)  , NOVOLATILITY-M EMBER  (NVOLM) 

NOVOLATI L ITU  -MEMBER 


VOLATILITY-SET  (VOLS)  , NOVOLATILTTY-SET  (N  VOLS) 


NOVOLATI LITY - S ET 


Examples:  PCOM  N*PA TROLL-PROCESSING  DESC 

PCOM  P DESC  PFCD 
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Coma  and : 

Pu  rpose: 

Pro*  oty pe: 

Para  meters 

Input- 

Data 


*->ssaqps : 


^xuidIps: 


B ENAM  E Type;  modifier  command 

To  chanqe  the  name  of  some  object  in  the  data  base 
and  to  produce  the  RFNAHE  REPORT  as  a peraanant 
record  of  the  chanqe. 

RFNAME(FEN>  {OLD  ( 0)  * user- nan  e NEW  (N)  auser-name) 
(INPUT(I) =fdname  ) 


INPUT  (I)  =f dname 


Defau’t.:  no  default 


por  multiple  name  chanqes,  an  input  file  can  be  used. 
Each  line  of  the  file  must  consist  of  the  old  name 
followed  by  th»  new  name.  The  two  names  must  be 
separated  by  one  or  more  blanks. 

OLD  (3)  =user-name  Default:  do  default 

The  user-name  specified  here  is  the  name  that  is  to 
be  chanqed,  This  name  must  be  defined  in  the  data 
base. 


NEW  (N)  =user-name  Default:  no  default 

The  user- name  specified  here  is  the  name  to  replace 
the  old  name.  If  the  new  name  is  already  in  the  data 
base,  the  name  will  not  be  chanqed. 

''or  a sinqle  chanqe,  both  OLD  and  NEW  must,  be  qiven 
with  leqal  values. 

If  neither  INPUT  nor  the  OLD  and  NEW  parameters  are 
specified  the  message: 

MUST  I I VE  OLD  AND  NFW,  OR  INPUT 

will  be  qiven. 

RENAME  OLD=  EMPLOY  EE- CODE  N E W=EM  PLOY  B E- N U NBE  R 
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Coaaard:  REPLACE-COMMENT-ENTRY  Type:  aodi.fi.er  coaaand 

Purpose:  To  replace,  for  a qiven  name,  specific  coaaeit 

entries  associated  to  it.  A REPLACED  COMMENT  ENTRIES 
report  is  also  printed  as  a peraanent  record  of  the 
change. 

Prototype:  REPL  ACE- CO  MM  ENT- ENTRY  (FCOM)  [ parameter  1. . . 

faraneters: 

Input-  I NPUT  (T)  * f dnane  Default:  (see  text) 

Data 

The  designated  fdname  contains  the  new  coaaent 
entries  that  will  replace  specified  old  comment 
entries  in  the  data  base.  The  required  torait  of  tha 
file  is  the  sane  as  that  punched  by 
PUNCH-CDdM  ENm-FNTFY.  If  INPUT  is  not  qiven,  the 
input  will  be  taken  fron  the  default  file.*  This  fila 
is  the  default  PUNCH  file  for  PCOM.  For  each  comment 
entry  to  be  replaced,  the  following  foraat  must  be 
given  in  the  input  file: 

name 

comment-entry  type; 


comment  entry  text 


Where  name  is  a name  defined  in  the  data  base,  the 
connent-en try- t ype  (c.q.,  DESCRIPTION,  VOLATILITY, 
etc.)  must  be  followed  by  a semicolon.  The  text 
following  this  must  also  he  followed  by  a semicolon. 
This  sequence  of  linos  can  be  repeated  as  many  times 
as  necessary  in  the  input  file. 

Output-  PRINT,  NDPRINT  (NOP)  Default:  PRINT 

Data 

The  print  parameter  initiates  the  production  of  the 
REPLACFP  COMMENT  ENTRIES  report;  NOPRINT  suppresses 
printing.  The  report,  if  produced,  contains  both  ths 
old  and  new  comment  entries. 

Examples:  3COM  NOPRINT 


* ""he  name  of  the  default,  file  is  installation  dependent  and 
consequently  is  qiven  in  Appendix  F. 
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Conn  and : 
Purpose; 
Prot  otype • 

Para  nepers: 

T n pu  t- 
Pa  ta 


Anal vsis- 
Cont  rol 


out  put- 
Pa  ca 


RE SOU RCE-C ON  SUMPTION-ANALYSIS  Type:  report  canaand 

To  produce  the  PE  SO UFCE-CONSU N PTION  REPORT 

RESOURCE- CON SUMPTION -ANALYSIS  (FCA) 

IN  TER V A L=user- na me  [ parameters ] 


PILE  ( F)  '=  f dnaoie  ],  NA  ME  (N)  = user -name  Default:  PILE 

When  the  FILE  parameter  is  used  and  no  fdnaaa  is 
designated,  the  contents  of  the  default  file  are  used 
as  input  to  the  command.  This  file  is  the  dafault 
PUNCH  file  for  NAME-OEN.  If  an  fdname  is  indicated, 
that  file  is  used  as  the  input  file  for  the  command 
and  the  report  is  produced  usinq  all  the  names  in  the 
file.  When  a single  name  is  specified  by  the  NANE 
parameter,  the  report  is  produced  for  that  name 
alone.  Either  FILE  or  NAME  can  be  used  but  not  both. 
In  any  case,  all  the  names  used  as  input  to  this 
command  must  he  PROCESS  names.  The  input  file  format 
is  one  PROCESS  name  per  line.  The  given  process-name 
is  used  as  the  name  of  the  root  process  from  which 
all  subsequent  analysis  proceeds.  The  report  will  be 
produced  onlv  for  consumption  of  resources  in 
oerforminq  this  process  and  its  component  processes 
as  determined  by  the  PROCESS  - LEVEL  parameter. 

PROCESS-t.EVFL  (PL)  = {ALL  ) Default:  ALL 

{number} 

This  parameter  specifies  the  lowest  level  of  the 
component  PROCESSES  relative  to  the  root  name  whose 
information  is  used  in  the  analysis.  In  short,  it 
corresponds  to  the  "depth"  of  UTILIZES  and  SI  BP ARTS 
connections  that  will  be  probed  from  the 
root- orocess.  If  ALL  is  in  effect,  probing  continues 
until  the  lowest  level  processes  are  reached. 

INTERVAL (I NT) = user-name  Default:  none 

”his  specifies  the  interval  in  terms  of  which  the 
analysis  and  report  production  is  done.  The 
user-name  must  he  an  INTERVAL  name.  All  necessary 
HAPPENS  statements  that  are  used  by  the  Analyzer  must 
be  in  terms  of  this  INTERVAL,  or  must  he  convertible 
to  it  (through  CONSISTS  OF  statements  in  the  INTERVAL 
sect  ion)  . 

RY  PROCESS  OR  (UP)  , NORYPROCESSOR  (NBP) 

Default:  BYPROCESSOR 

When  the  RYPROCFSSOF  parameter  is  in  effect,  the 
Resource  Consumption  Report  arranged  by  PROCESSOR 
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name  is  presented.  when  NOBYPROCSSSOR  is  in  effect, 
it  is  not  presented. 

byresourif  (br)  ,nobyresource  (nbr) 

Default:  BYRESOURCE 

When  th=»  BYRESOURCE  parameter  is  in  effect,  the 
Resource  Consumption  Report  arranged  by  RESOURCE  name 
is  presented.  When  NOBYPESOURCE  is  in  effect,  it  is 
not  presented. 

I NDEX ,NOI NDEX  Default:  NOINDRX 

The  INDFX  parameter  specifies  the  production  of  an 
index  for  the  Resource  Consumption  Report.  This 
index  consists  of  an  alphabetical  listing  of  all  URL 
user-names  included  in  the  report  and  the  page(s)  on 
which  they  occur. 

PROCSS  SOP -KEY WORD  (PK)  = 

{ ALT  ) Default:  ALL 

{ user-name) 

This  narameter  specifies  that  only  those  processors 
with  a given  key  will  Mve  pr  ocessor-  reso  urce 
utilization  reports  produced.  The  user-name  must  be 
a KEYWORD  name.  If  AU.  is  in  effect,  all  PROCESSORS 
that  are  used  to  perform  the  qiven  process  will  have 
this  report  produced. 

"xam  ole:  R EROtIRCE  - CON  SUMPTION -ANALYSIS 

N=1AIN-PR  CCESS  INC  INTER  VAI.=  YEAR 

RCA  I NTFP  V AL  = KONT  H INDEX  PL= 1 PK= HARDWARE 


i I 


. J 

j 


* 
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Cont rol 
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SFCURITY-ANALYSTS  Type:  report  command 

To  produce  the  SFCURTTY  ANALYSIS  repart. 

S ECtlR  I TY- ANALYSIS (SEC A)  f para aet or s ] 


FILF(F)  '=fdname},  NAME  (N)  =user-name  Default:  FILE 

When  the  FILE  parameter  is  used  and  no  fdname  is 
designated,  the  contents  of  the  default  file  are  use! 
as  input  to  the  command.  This  file  is  the  dsfault 
PUNCH  file  for  NANS-CFN.  If  an  fdname  is  indicated, 
that  file  is  usel  as  the  input  file  for  the  command 
ant  the  report  is  produced  using  all  the  names  in  tha 
file.  When  a single  name  is  specified  by  tha  NAME 
parameter,  the  report  is  produced  for  that  nrnme 
alone.  Either  FILE  or  NAME  can  be  used  but  not  both. 
In  anv  case,  .all  the  names  must  be  data  types  (SETS, 
INPUTS,  OUTPUT*,  ENTITIES,  GROUPS,  ELEMENTS)  or  types 
which  potentially  access  data  types  (PROCESSES, 
INTERFACES,  PROCESSORS)  . The  input  file  format  is 
one  user  name  per  line.  The  report  will  be  produce! 
for  each  name  in  the  input  file. 

PR TNT -NULL -SECURITY-  INFORMATION  (PN  SI) 

VOPRI  NT-NULL-S'TIIRITY-TNFORMT  ION  (NPNSI) 

Default:  NPNSI 

Tf  tn is  parameter  is  specified,  a list  is  produced  of 
names  in  the  data  base  for  which  security  information 
could  be  defined  but  for  which  security  information 
has  not  heen  defined. 

PRTNT-HATFIX  (PMAT)  , NOPRINT-MATRIX  (NPNAT) 

Default:  PMAT 

If  this  parameter  is  specified  the  security  conflicts 
matrix  is  printed.  otherwise,  the  matrix  is  not 
print  ed. 

INDFX,  NOT NPEX  Default:  NOINDEX 

The  ind»x  parameter  specifies  the  production  of  an 
index  for  the  Security  Analysis  Report.  This  index 
consists  of  an  alphabetical  listing  of  all  user-names 
included  in  the  report  and  the  page(s)  on  which  they 
occur . 

S FCIIR  ITY-  A NALY  SI  S N A ME  = hour ly -empl  oy ee-proces  s i ng 
PNS* 

“ FCA  TNDFX 
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Command:  STRUCTURE  Type:  report  command 

Purpose:  To  produce  a STRUCTURE  report  for  INPOTS,  OUTPUTS, 

PROCESSES,  INTERFACES  or  PROCESSORS. 

Prototype;  STRUCTUPE  (STR)  [ par amet  er  ]. . . 

Parameters: 


output-  INPFX,  NOT NDEX  De fault:  NDINDEX 

Pat  a 

The  INDEX  parameter,  when  given,  specifies  the 
production  of  an  index  to  the  report,  giving  the 
pages;  on  which  each  undefined  name  used  in  the  report 
occurs.  NOTNDEX  specifies  that  no  index  should  be 
qener  at  e 1 . 

Ou  tout* 

Opti on 


UFA  will  produce  structure  reports  tar  the  fallowing 
r\a»f»  types  when  given  as  parameters.  (Only  on-  may 
he  given  for  each  report.) 

INPUT  (TNP)  Default:  PROCESS 

OUTPUT  (OUT) 

PROCESS  (PFOC) 

TNTVPEACE(TNTF)  » 


PROCESSOR  (PRCR ) 

Output-  INDENm  (TNP)  = integer  Default:  INDENT-3 

format 

"he  number  is  the  number  of  spaces  to  indent  each 
succeeding  level  in  the  report.  INDENT  aust  taXe  on 
son-’  value  greater  than  C and  less  than  11. 

Examples:  STRUCTURE 

STR  INPUT 


1 Rp AL-WORID- ENT  ITT  (RWE)  may  be  used  in  place  of  INTERFACE, 
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Conmanl:  SUMMARY  Default:  report  conanl 

Puroo.se;  To  produce  the  DATA  PASE  SUMMARY  output. 

Prototype:  SUMMARY  (SDN) 

Parameters: 

no  Di  rams t ers 
picai»  oles : SUMMARY 

SUN 
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TNTpnrticTnN 

Whpnpvpr  an  orqaniration  develops  an  information  system,  one  of 
t-he  malor  problems  is  maintaininq  it  over  its  life.  Tha 
levelopers  of  the  systea  are  rarely  around,  or  available  to  help 
the  maintenance  qroup  in  their  task.  A frequent  result  of  this 
situation  is  a complete  redesiqn  and  redevelopmen t of  the  systei 
to  wake  relatively  ainor  modifications  to  the  systea.  5uch 
practice  is  an  obvious  waste  of  resources  that  could  have  been 
avoided  with  proper  documentation.  While  the  above  is  a stronq 
motivator  for  the  need  for  documentation  standards,  there  are 
other  advantaqes  involved,  namely,  better  communication  between 
developers  of  the  systea,  easier  traininq  of  new  employees,  etc. 
Honce,  most  ocqa n iza t ion s have  developed  their  own  standards 
which  must  be  adhered  to  for  documentinq  the  systea.  Examples 
of  such  standards  are  MILITARY  standards  481  and  490  and 
nepartment  of  Offense  Manual  412G.17-H. 

"uch  of  the  inforaation  that  is  needed  in  the  final  document 
lescribinq  the  systea  may  be  obtained  durinq  the  system's 
analysis,  desiqn,  and  construction  phases  of  the  development 
life  cycle.  Therefore,  what  is  needed  is  a mechanist  that  will 
allow  the  capture  of  the  information  as  and  when  it  becomes 
available  ind  storinq  it  in  a readily  usable  data  base.  This  is 
where  rhe  fJRL  /HP  A data  base  comes  into  the  picture. 

■"h®  Automated  Docum*  nt.at  ion  System  provides  the  means  of  easily 
producing  a document  accordinq  to  a specific  standard.  The 
process  of  creat inp  the  document  is  a three  step  procedure.  A 
t lhl e of  contents  or  structured  outline  for  the  desired  document 
must  be  completed.  This  information  must  be  stated  in  a 
prescribed  format  (see  Section  1).  This  part  of  the  process  is 
referred  to  as  the  creation  of  the  documentation  schema.  The 
Anal  yzer  data  base  is  used  to  score  and  easily  keep  the 
information  about  the  system  beinq  documented  current.  The 
Anal yzer  data  base  is  created  by  an  analyst  or  documentor  who  is 
concerned  with  capturinq  an  up-to-date  and  complete  description 
of  the  system.  There  is  no  orderinq  to  these  steps.  The 
analyst  or  documentor  must  insure  that  all  information  required 
by  the  documentation  standard  is  in  the  Analyzer  data  base.  Th? 
third  part  of  the  documentation  procedure  is  to  describe  the 
document  body  in  a prescribed  format  (see  Section  2).  The 
process  is  referred  to  as  the  creation  of  the  documentation 
source.  Consistency  and  coordination  between  the  documentation 
schema,  documentation  source  and  Analyzer  data  base  is  required 
♦•o  automatically  qenerate  qood  document. 

"he  three  components  of  the  Automatic  Documentation  Systea  are 
“he  documentation  schema,  the  documentation  source  and  the 
Analyzer.  These  areas  are  liscussed  in  this  Part  to  clarify  the 
usaqe  of  these  terms  and  other  terms  in  this  Part,  a qlossary  is 
incl uded . 
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1,0  Document.  Ini  tial  izat^on 

The  initialization  for  the  Automated  Documentation  System  must 
he  performed  for  each  project  to  he  documented.  This  task  may 
he  performed  by  the  project  leader.  It  involves  taking  the 
Military  Standard  and  deriving  from  them  relevant  headings  for 
the  particular  prolect  in  mind.  For  this  paper  Military 
standard  412b.  n-M  will  be  used  is  the  basis  (template;  foe  the 
oeneration  of  the  document.  Portions  of  this  document  are  shown 
in  the  example  (Apnendix  P) . The  initialization  allows  the 
project  director  to  identify  the  major  and  detailed  areas  of 
documentation  to  be  produced  by  the  project  team  members.  It 
can  be  most  succinctly  expressed  as  the  table  of  contents  to  be 
shown  in  the  final  d ocumenta ti or . Hence,  the  documentation 
schema  is  equivalent  to  a listing  of  the  entries  in  the  table  of 
contents  or  structured  outline  of  the  desired  document.  The 
details  of  the  syntax  will  he  discussed  in  Section  1.2. 
Development  of  a documentation  schema  is  discussed  in  Section 
4.1.  Section  1,1  will  discuss  some  of  the  strategy  to  be 
followed,  and  the  general  initialization  process.  The  and 
result,  of  the  initialization  process  is  a documentation  object 
sche  *a . 


1.1  The  Document  a r i . n Schema  - S tra teg y f or  the  Document 
Init  iali  zat  i or. 

""her0  are  basically  t nree  types  of  entries  that  may  be  antered 
into  the  documen tat i on  schema.  Any  entry  line  is  a maximum  of 
a'  characters.  The  entries  may  be  typed  in  on  cards,  or  other 
media;  in  this  form  they  are  known  as  documentation  source 
schema.  when  these  same  entries  have  been  entered  on  a file  on 
the  target  computer  which  also  has  th°  Analyzer  data  base  on 
file,  the  entries  ire  know  as  the  documentation  ‘b.ie£:  schema, 
"he  process  of  converting  tne  source  schema  intc  the  otnect_ 
schema  would  generally  involve  nothing  more  than  reading  ir  the 
cards,  etc.,  into  a file.  The  source  schema  is  external,  to  the 
computer  while  the  object  schema  is  stored  in  a file.  3ne  of 
the  mos*  common  ways  of  doing  this  is  by  a locaL  text  editor,  or 
some  other  file  copulating  mechanism.  This  processor  (editor, 
etc.)  is  known  as  the  documentation  initializer  (Figure  67). 

The  three  types  of  entries  that  may  be  entered  into  the 
docu lent ation  schema  are; 

- the  *•  a hie  of  contents  (SECTION  ENTRIES) 

- formatting  commands  (TEXT  FORMATTING  ENTRIES) 

- comments  (COMMENT  ENTRIES) 

The  table  of  contents  entries  are  all  preceded  by  a 
distinguishing  character,  which  must  ne  entered  on  avery 

heading  to  appear  in  the  table  of  contents.  Formatting  commands 
ar°  proceeded  by  the  distinguishing  character 
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Finally,  the  manaqer  may  want  to  insert,  into  the  documant  at  ion 
schema,  personal  comments  which  are  not  to  appear  in  the  final 
tahle  of  contents.  These  may  be  specified  by  a "6"  followed  by 
a comment  of  up  to  7°  characters.  Should  the  comment  be  longer, 
it  may  be  continued  on  the  next  line  but  preceded  by  another 
"S".  Comments  may  be  used  to  quide  the  documentors,  to  assign 
specific  portions  of  the  documentation  to  particular 
individuals,  etc.  Any  formatting  command  that  appears  in  the 
schema  will  be  executed  directly  before  the  section  is  printed 
in  the  docuient.  This  characteristic  will  be  discussed  in 
Sect  ion  4. 1. 
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1 • 2 Syntax  £or  Entries  i_n  t l^e  Documentation  Schaja 

SECTION- ENTRIES  have  the  following  syntax: 

ISPCTTON-IDPNTI FI ER  [ HEADI NG-ENTRX ] 

The  sect  ion- i don t if i er  must  be  preceded  by  a "I"  in  column  1. 

The  sect,  ion- iden  t if  i e r is  the  unique  string  corresponding  to 
that  section  of  the  documentation  schema  (e.g.,  2.2.3).  This 
spring  mav  be  wide  up  of  numbers,  characters  and/or  special 
characters.  So  particular  restrictions  are  placed  on  the  format 
of  *-he  identifier  (except  for  those  placed  or  by  a specific 
installation's  control  characters)  ; for  example,  an  identifier 
of  1.2s.l.h  is  a perfectly  legitimate  identifier.  The  section 
antrv  may  not  exoeel  SC  characters.  It  is  important  to  note 
'hat  there  must  he  ot  least  one  space  between  the  identlfer  and 
the  heading  entry.  The  final  documentation  will  be  produced  in 
the  order  that  the  identifi?rs  were  entered  in  the  docua en tat  ion 
schema.  Heice,  it  is  the  responsiblity  of  the  individual 
preparing  the  documentation  schema  to  enter  them  in  the  proper 
order.  The  doou ment ation  generator  will  not  check  to  see  that 
those  are  sorted.  The  heading-entry  is  the  title  to  be  given  to 
tie*  section.  This  is  the  title  that  will  appear  in  the  final 
doeu men  t . 

TEXT- POP  MATT  I N(>- FNTR  I ES  have  the  following  syntax: 

♦CONTROL- I N FORMATION- ENTRY 

""he  text  formatting  commands  may  also  be  interspersed  anywhere 
in  the  schema,  but  must  be  preceded  by  a in  column  1.  Thera 

k-’  two  functions  of  formatting  commands.  A command  can  control 
what  is  going  to  he  done  at  a certain  point  in  regards  to 
snaring  or  control  the  global  options  of  formatting. 

The  following  options  can  he  used: 


MEW-PAG  F 

Skip  to  th=  top  of  the  next  page. 

♦skip  f n 1 Default : N = 1 

Skin  N lines.  Tf  N is  greater  than  the  number  of  lines 
lef  *■  on  a page,  then  this  command  causes  carriages  to  skip 
to  the  top  of  t he  next  paqe. 

•H1I.P-BI  ANT  [11  Default:  N*1 

Check  to  see  if  N lines  are  left  on  this  page.  If  there 
are,  skip  v lines.  Tf  there  are  not.,  skip  to  the  next  paga 
and  then  skip  N lines.  This  option  insures  that  enough 
space  will  be  left  on  a single  page  for  a diagram  or  table 
to  be  written  ir  manually. 

*'(0LD(N1  Default:  N*d 

The  rest  or  the  current  page  is  checked  to  see  if  N lines 
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are  left  on  the  page  (not  including  HEA DINS  or 
BOTTOM- LINES) . If  N lines  are  left,  the  next  line  of  the 
source  data  base  is  produce!.  If  N lines  are  not  left  on 
the  current  paqe,  skip  to  the  top  of  the  next  page  and 
produce  the  next  line  of  source. 


These  options  are  present,  at  the  coinonceient  (under  their 
default  conditions  and  can  be  changed  throughout  the  source): 


♦TITLE  (OFF 1 Default:  OFF 

(Title) 

If  a title  is  given,  this  title  is  put.  on  the  top  „f  each 
page.  If  off  is  given,  no  title  is  printed  on  each  page. 


•HEAPING  (7  FF)  Default:  ON 

(ON) 

If  ON  is  specified,  the  HEADING-ENTRY  for  the  last  section 
printed  is  nut  at  the  bottom  of  each  paqe.  If  off  is 
specified,  the  HEADING-ENTRY  is  not  nut  at  the  bottom  of 
each  page, 

•Tgp-LTNES  * N ] Default.:  N = 3 

Skip  N lin*s  3t  the  bottom  of  each  page.  Range  is  from  0 
to  in. 


•BOTTOM- LTNEF  [ N ) 

Skip  N lines  at  th«  bottom  of  each  page, 
to  10. 


Default:  N*2 
R a nq e is  f r oo  0 


♦LIN  *S  [ N]  Default:  N*60 

N is  the  number  of  lines  to  be  printed  on  a page,  including 
Title  and  Heading.  Range  is  from  S to  60. 

•SOURCE-MARGIN  [ M ) Default:  *' 

N is  the  number  of  spaces  *0  indent  the  actual  text 
material.  This  does  not  affect  Analyzer  report, 
indentation.  Range  is  from  1 to  40. 


HEADING-MARGIN  * N ) 

N is  the  number  of  spaces 
Range  Is  from  1 to  uC. 


JefaUit:  N =1  0 

to  indent  a section  heading. 


♦ HrADTNG-RMIP  [ N ) 

N is  the  number 
section -header, 
top  of  the  next 


Default  N=2 

of  lines  to  skip  before  printing  a 
The  amount  skipped  will  at  most  be  to  the 
page.  Range  is  from  0 to  f>3. 


♦PEPOPT-CC  (OFF)  Default:  ON 

(ON) 

When  set  to  ON,  the  Analvzer  report  carriage  control  is 
engaged  when  outputting  Analyzer  reports.  This  affects 
page  feeding  of  the  document  produced.  whon  OFF,  the  line 
skippinq  and  page  feeding  is  controlled  by  only  formatting 
commands. 
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COii ENT-ENTR IPS  have  the  following  syntax: 

5 COHEN? 

Comments  may  b®  interspersed  anywhere  in  the  documentation 
schema.  They  will  not  appear  in  the  final  output.  The  "6"  must 
aopear  in  column  1.  The  comment  on  a given  line  can  be  a 
maximum  of  79  c icters,  ""here  is  no  limit  to  the  number  of 
comment  entries  and  header  entries  in  a documentation  source 
schema.  An  example  of  a documentation  source  schema  is: 

• 2.  PROJECT  DE  VEI.OPMFNT  E N VT  RONMENT/DOCUHENT AT  ION  SYSTEM 
*2.1  DEVELOPMENTAL  PHASES 

• 2.  1.  1 INITIATION 

SPHERE  SHOULD  BE  NO  NEED  TO  HAVE  ANY  OTHER  LISTS  ED R DS . 

(A  larger  example  is  in  Appendix  F.) 


•-1 


t 


i 
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2.0  Documentation  Source  Population 

The  actual  documentation  to  he  written  would  probably  ba  done  by 
more  than  one  individual.  These  individuals  may  enter  the 
documentation  of  the  areas  they  are  responsible  for,  into 
different  files,  or  into  one  common  file  assigned  to  be  shared 
by  them.  In  the  former  case,  the  documentation  manager  must, 
merge  the  different  pieces  of  the  documentation  into  a single 
file.  The  order  of  this  file  is  not  important,  as  the  final 
documentation  will  be  produced  in  the  order  specified  by  the 
documentation  schema  {see  Saction  1).  The  input  foe  the 
documentation  source  is  referred  to  as  the  documentation  source 
input. 

The  documentation  source  contains  the  information  on  the 
contents  of  the  document  body.  This  information  is  expressed  by 
various  types  of  entries.  There  are  five  entry  types: 

Sect  ion- entr ies,  ana lyzer-comman  1-entries, 

t ext-f ormat ti ng- ent r ies,  comment-entries  and  text  entries. 


2.1  Strategy  for  th  s Documentation  Source  P2Ea.iiii.21 


It  is  important  that  the  individuals  who  are  going  to  document 
the  system  know  what  is  in  the  Analyzer  data  base.  They  should 
be  given  a complete  NAME-LIST1  (or  NAME-GEN  1)  of  names  in  the 
Analyzer  data  base.  They  should  have  a 

ATTEO-PROBLEM-ST  AXEMEN*  1 of  all  these  names,  or  have  access 
via  a terminal,  to  the  Analyzer  data  base  to  guerv  the 
information  within  it.  For  example,  if  the  documentation  calls 
for  the  description  of  a particular  input  (say  r EST- RESU LTS)  , 
this  should  be  in  the  Analyzer  data  base,  and  the  documentor 
should  be  reguired  to  invoke  its  description  from  tne  Analyzer 
data  base  rather  than  to  have  to  retype  it.  This  has  two 
obvious  advantages:  the  one  mentioned  above  (redaction  of 
redundant  work),  and  the  other  one  of  always  having  an 
up-to-date  description  of  the  item  of  interest.  It  is  the  duty 
of  the  project  manager  to  see  that  all  Analyzer  entries  have 
been  made,  and  do  exist.  The  above  also  implies  that  the 
documentor  be  quite  familiar  with  the  use  of  the  Analyzer. 

The  individuals  populating  the  documentation  source  must  also 
have  access  to  or  a copy  of  the  documentation  schema,  and  must 
use  the  same  sec t ion- identif ie rs  as  used  in  the  schema.  It  is 
also  feasible  to  have  a limited  amount  of  text  formatting 
capability  such  as  getting  to  the  top  of  the  next  page,  or 
skinping  to  next  half  page,  etc.  This  capability  would  be  used 
where  a diagram,  or  table  (which  could  not  be  drawn  by  the 


1 Part  TV,  "User  Requirements  Analyzer  Command  Descriptions”  and 
Part  III,  "'JPA  Outputs"  for  an  explanation  of  these  commands  and 
corresponding  outputs. 


‘ 
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documentation  generator)  had  to  be  inserted,  and  room  had  to  be 
left  for  it.  An  entry  line  for  the  documentation  data  base  is  * 
maximum  of  t 2C  characters. 

To  distinguish  between  the  various  kinds  of  entries  in  the 
documentation  souroa,  Analyzer  command  entries  ate  preceded  by  a 
"V  in  column  1,  t ex  t -f  or  mat  t i ng  entries  are  preceded  by  a 
in  column  1,  and  th?  actual  text  itself  has  nothing  preceding 
it,  and  begins  in  column  1.  Preceding  blanks  are  considered 
oart  of  th»  text,  in  entry  line  for  the  documentation  data  base 
is  a maximum  of  123  characters.  Text  entries  have  no  specific 
format. 

The  documentation  source  may  be  populated  by  the  documentors  in 
much  the  same  way  as  the  documentation  schema  (Pigure  69),  i.e., 
any  processor  such  as  the  text  editor,  file  populatoc,  ate.,  may 
b*3  used  to  store  the  source  in  the  documentation  data  base  which 
must  he  a file.  Tf  several  documentors  are  working 
simultaneously,  different  files  may  be  assigned  to  individual 
documentors.  These  portions  of  the  data  base  can  then  be  merged 
at  documentation  generation  time.  The  order  of  the  section 
entries  is  unimportant. 


2.2  Syntax  for  ^.he  Documentation  Source 

SrCT ION- ENTRIES  have  the  following  syntax: 

• SpCTT3N-ir>ENTIPT  FR  [ HEADING -COMMENT  ] 

The  section  entries  are  the  same  as  in  the  documentation  schema. 
However,  the  text,  portion  (headinq-comment)  in  the  documentation 
source  is  ignored.  Only  the  section-identifier  is  used  to  match 
against  the  documentation  schema.  The  must  be  in  column  1. 

ANAL  Y7IFR-C0MM  AND-ENTRIFS  have  the  following  syntax: 

*ANAL  YZEF -COMMAND 

Analyzer  commands  may  be  interspersed  anywhere  in  the  text  with 
the  provision  that  they  be  preceded  by  a in  column  1.  Any 

Analyzer  commands  from  Part  IV*  are  allowed  except  the  STOP 
command  and  the  SET  command  with  the  option  PROflPT-ON  ia  effect 
( b v default  it  is  not  in  effect).  The  commands  are  not  execute} 
immediately  . They  are  -just  stored  as  is  until  the 
documentation  generation  process. 

TEXT- FORMATTING- ENTRIES  have  the  following  syntax: 

•1‘ONTROL -I  NPORMATTON-  ENTRY 
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,h«  text  for  matt ing  conands  available  to  use  in  thu  schema  will 
also  be  available  to  use  in  the  -source.  These  commands  wer» 
explained  in  Section  1.2.  They  may  be  interspersed  anywhere  in 
the  documentation  source.  The  must  be  in  column  1. 

v.01111  FHT*I!NIISSS  have  the  following  syntax! 

RC0MH8NT 

Comments  may  be  interspersed  anywhere  in  the  documentation 
source.  They  will  not  appear  in  the  final  output  (same  as  in 
►he  schema).  The  "S"  must  be  in  column  1, 
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’.0  Ike  22£llI£Ilt2tl2D  £>?Q er a li2H 

The  documentation  qaneration  may  be  performed  by  the  project 
manager  when  one  wishes  to  have  the  completed  documentation. 

The  manager  may  first  wish  to  ascertain  that  the  documentation 
is  indeed  complete.  It  is  possible  for  the  manager  to  find  this 
out.  However,  the  extent  of  checking  is  limited  to  the  absence, 
or  presence  of  an  entry  in  the  documentation  data  base 
corresponding  to  every  entrv  in  the  schema.  There  is  no  check 
to  find  out  if  the  corresponding  Analyze r data  base  entries  also 
exist . 

If  the  prolect  manager  finds  that  all  entries  in  the  schema  have 
corresponding  entries  in  the  source,  one  can  now  go  ahead  and 
initiate  the  generator  to  produce  the  final  documentation  as  per 
the  specification  in  the  documentation  schema.  The  manager  must 
realise  that,  this  will  be  a lengthly  process,  as  it  involves  the 
invocation  of  several  analyzer  commands,  the  generation  of 
intermediate  files,  and  the  merging  of  several  files  to  produce 
the  final  documentation  (Figure  69).  Hence,  it  is  recommended 
that  this  be  done  in  batch  mole.  However,  because  the  Analyzer 
processor  is  being  run  when  the  documentation  is  desired,  it 
will  be  using  the  latest  version  of  the  description,  etc.,  that 
are  available  as  in  on-line  Analyzer  usage. 

The  process  that  the  Documentation  Generator  goes  through  is 
shown  in  Figure  69.  it  involves  two  steps.  Phase  I (CHECK) 
checks  to  see  what  Section  Entries  in  the  schema  are  prssent  in 
the  documentation  source.  It  also  extracts  all  Analyzer 
commands  from  the  source  and  writes  them  into  a separate  file  to 
he  used  as  inpu-.  to  the  Analyzer.  Phase  II  (MERGE)  merges  the 
output  from  the  Analyzer  with  the  documentation  source  and 
produces  the  document.  It  is  at  this  point  that  the 
text-formatting  commands  are  processed. 

"he  procedure  for  documentation  generation  is  dependent  on  the 
operating  system  under  which  the  Automated  Documentation  System 
is  installed.  Hence,  there  is  no  one  way  to  invoke  the 
Automated  Documentation  System.  Appendix  H will  include  the 
system  dependent  information  required  to  execute  the  Automated 
Documentation  System  and  generate  a document. 
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4.0  Usage  of  the  PoSUSSSt at^on  Generator 

In  using  the  document at  ion  generator,  there  are  several  areas 
that  need  to  be  considered  in  order  to  achieve  a desired  quality 
level.  Coordination  between  the  schema,  Documentation  lata  basa 
and  Analyzer  data  base  are  mandatory  in  order  to  develop  a 
document  which  will  contain  complete  information.  Development 
of  the  methods  to  produced  these  three  inputs  into  the  3ystem  so 
that  they  can  be  used  in  an  ongoing  operation  (camera-ready 
documentation)  is  the  topic  of  this  section.  Considerations  as 
to  what  should  be  included  in  each  component,  what  pitfalls 
should  be  watched  out  for,  and  what  variations  might  arise  in 
usage  of  the  documentation  generator  will  be  discussed.  It  is 
important  for  the  reader  to  realize  at  this  point  that  while 
this  system  has  been  developed  to  provide  a generalized  format 
for  producing  documents  under  a set  of  standards,  the  system 
still  allows  a great  deal  of  flexibility  to  the  user. 

Department  of  Defense  Manual  4120.  17-M  along  with  MIL  standard 
483  will  be  used  as  example  documentation  standards  in  this 
discussion.  Development  of  a Functional  Description  and  Data 
Peguirements  Document  of  the  Pay  System  Analyzer  data  base  (W.P. 
14)  » will  he  used  as  a specific  example  (Appendix  F)  . 


4.1  Peye  jopm e nt  of  thg  Docunent a t j on  Schema 

The  documentation  schema  consists  of  a structural  outline  or 
table  of  contents  of  the  particular  document  being  produced. 

From  this  schema  a table  of  contents  for  the  document  being 
generated  will  oe  produced.  Hence,  it  is  important  that  the 
user  include  enough  section  levels  in  order  to  make  the  table  of 
contents  meaningful.  It  is  also  important,  to  note  that  the 
final  documentation  will  he  produced  in  the  order  stated  in  the 
documentation  schema,  so  the  schema  should  be  sat  up 
anpropriatel y. 

Format  for  the  schema  is  discussed  in  Section  1.  The 
documentation  initializer  (sea  Figure  64)  produces  the 
documentation  an)  schema  which  is  stored  permanently  on  file 
after  any  required  editing  is  done. 

within  ^ he  schema,  comments  and  formatting  commands  are  allowed, 
"he  schema  is  chocked  to  see  if  it  contains  any  formatting 
commands.  If  it  does,  each  formatting  command  goes  into  effect 
prior  to  the  printina  of  the  section  header  and  immediately 
following  the  formatting  command.  This  is  also  true  for 
commands  at  the  beginning  of  the  schema. 

Although  it  is  suggested  that  the  table  of  contents  of  a 
particular  document  or  standard  be  used  as  the  schema,  xany 
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times  a more  let  ailed  schema  is  warranted.  Situations  where 
sore  or  less  detail  might  be  deemed  necessary  are  in  the 
following  subsections. 


4.1.  1 wh ere  j,ess  22tSil  ai^nt  Necessary 

’’’he  tnbl®  of  contents  ot  a certain  standard  is  a skeleton  type 
set.  up,  giving  suggestions  or.  how  the  documents  should  be 
developed,  but  leaving  room  for  variances  in  structure  from  one 
document  *o  another  written  according  to  the  standard.  In  this 
case  it  might  be  wise  to  use  less  detail  in  the  schema  and  keep 
i*  as  general  as  possible. 

An  example  of  where  this  situation  arises  is  in  NIL  standard 
441.  in  section  3.2,  the  standard  sets  up  the  criteria  for 
describing  each  separate  function  of  a system.  Since  there  is 
loinq  to  be  a varying  m.R her  of  functions  in  different  s /stems, 
the  standard  sets  no  the  description  as  follows: 

3.2. X  ^unction  V 

3.2.  X. 1 T N PUTS 

3. 2. X. 2 processing 

3.2.  X.  3 OUTPUTS 

Thus,  this  basic  structure  is  repeated  for  every  function  in  the 
system.  This  muses  a definite  problem  when  using  the  document 
generator.  Since  it  is  desirable  to  have  one  schema  for  all 
documents  produced,  it  can  be  seen  that  since  the  number  of 
functions  will  vary  from  one  system  to  the  next,  tha  standard's 
table  of  contends  cannot  be  followed  strictly. 

Three  options  are  open  to  'he  documentor  in  cases  like  this. 


•a)  Tnclule  in  the  schema  only  the  section  header  (#3.2 

OF^AIIED  FUNCTIONAL  SF  J CII 3 * ? NTS)  and  leave  the  rest  to  oe 
described  i r.  the  source.  Comment  entries  could  be  included 
in  the  schema  to  describe  what  should  be  included  «ith 
these.  The  alvantaqe  of  this  option  is  that  the  scheoa 
will  ha  constant  and  independent  of  each  instance  of  ti.xs 
document.  The  disadvantage  is  that  the  schema  will  nov 
lack  information  and  the  table  of  contents  will  be  soa*  wnat 
incompl et®. 

#3.2  OET  AIT,  '■p  FUNCTION  REOUIP  EH  ENTS 
1 PARAGRAPH  3.  2 X FUNCTION  X. 

S THF  HASTC  P A R AG  PAP  H FOP  EACH  FUNCTION  SHALL  BEGIN  W X Td 

*.  r>ESCnT  PTIVE  AND  INTRODUCTORY  MATERIAL  NHICH  DEFINES 

S HE  FU  NCI  ION  AN  0 ITS  R FL  AT  ION  S H 1°  TO  OTHER  FUNCTION*.', 

?.  THEN,  THF  FOLLOWING  THRFE  SUBPARAGRAPHS  SHALL  SPECIFY 

£ THF  OUAIITATIVE  RFC"  I REH  ENTS  CONCERNING  THE  FUNCTION. 

•,  PARAGRAPH  3.2.X.1  INPUTS. 

£ PARAGRAPH  3.  2.X.  2 PROCESSING. 

S PARAGRAPH  3.2.X.3  OUTPUTS. 
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Set  up  the  schema  for  an  arbitrary  nuaber  of  functions.  An 
exanple  of  this  would  be: 


• 3.  2.  1 

<n.  2.1.  1 

*3. 2.  1.  2 
•3. 2.1.  3 
*3. 2.2 

• 3. 2.2.  1 
#3.  2. 2.  2 

• 3.2.2.  3 


PUNCTTON  ONF 
III  PUTS 
P ROCS  5 SI  VP 
OUTPUTS 
'■UNCTION  ONF 
I SPUTS 
PROCESSING 
OUTPUTS 


• 

*3.2.12  "UNCTION  THELVF 
• 3.  2.  12.  1 INPUTS 
*3.2.12.2  PROC  F SSI  NG 
*3.  2.  12.  3 OUTPUTS 


The  advantage  of  this  option  is  that  the  table  of  contents 
is  complete.  The  lisadvantaqe  is  that  the  entries  in  the 
table  are  not  meaningful. 


Include  in  the  schema  the  actual  function  nanes  for  each 
system.  An  example  of  this  would  be: 


*3.  2 
*3.  2.  1 
*3. 2.1.  1 
*3.  2.  1.  2 
*3.  2.  1.  3 
*3. 2.2 
*3.2.  2.  1 
*3.  2.2.  2 
*3.  2. 2.  3 
*3. 2. 3 
*3. 2.3.  1 
*3. 2. 3. 2 
*3. 2.3.  3 
*3. 2.4 

*3. 2.4.  1 
*3. 2.4.  2 
*3.2.  4.  3 
*3.  2.S 
*3. 2.5.  1 

• 3.  2.  5.  2 
*3.2.5.  3 

♦ 3.  2.5 
*3.  2.6.  1 
*3.  2.6.  2 
*3.  2.6.  3 
*3.2.7 


OFT  AILED  FUNCTION  REQUIREMENTS 

SENSOR  CALIBRATION  (INITIAL)  FUNCTION 

INPUTS 

PROCESSING 

OUTPUTS 

FL5MFNT  CORRECTION  (INITIAL)  FUNCTION 

INPUTS 

PROCFSSINP 

OUTPUTS 

MANEUVER  DETERMINATION  CONTROL  FUNCTION 

INPUTS 

PROCESSING 

OUTPUTS 

SIMULTANEOUS  SOLUTION  OF  MANEUVER  AND  ELEMENT 

FUNCTIONS 

INPUTS 

PROCESSING 

OUTPUTS 

ELEMENT  MAINTENANCE  CONTROL  FUNCTION 

INPUTS 

PROCESSING 

outputs 

EI.FMFNT  CORRECTION  (ROUTINE)  FUNCTION 

INPUTS 

PROCESSING 

OUTPUTS 

OBSERVATION  EDITING  FUNCTION 
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#3.  2.7.  1 
#3. 2.7. 2 
#3.2.7.  3 
#3.  2.9 
*3.  2.8.  1 
*3. 2.9.  2 
#3. 2.8.  3 
#3. 2.9 
#3. 2.9.  1 
#3.2.9.  2 
#3.  2.9.  3 
*3. 2. 13 
#3.  2. 17.  1 
*3. 2. 10.  2 
#’ . 2.  10.  3 
#3.2.11 
#3. 2.11  . 1 
#3. 2.  11. 2 
*3. 2.11. 3 
• 3. 2.  12 

#3. 2.12.  1 
#3.  2.  12.  2 
#3. 2.12.  3 


INPUTS 

PROCESSING 

OUTPUTS 

SFNSOR  CALIBRATION  (ROUTINE)  FUNCTION 

INPUTS 

PROCESSING 

OUTPnTS 

ELEMENT  RECOVERY  CONTROL  FUNCTION 

INPUTS 

PROCFSSING 

OUTPUTS 

ELEMENT  CORRECTION  (RECOVERY)  FUNCTION 

INPUTS 

PROCESSING 

OUTPUTS 

MANEUVER  PET ECTTON  FUNCTION 

INPUTS 

PROCESSING 

OUTPUTS 


MANUAL  INTERACTIVE  DIPER  RENTIAI  "ORRECTION 

"UNCTION 

INPUTS 

PROCESSING 

OUTPUTS 


The  advannge  of  this  method  is  that  the  schema  is  complete 
and  descriptive.  The  disadvantage  is  that  the  schema  will 
have  to  he  changed  for  each  application  document. 


The  decision  as  to  which  one  of  these  options  should  be 
used  is  up  to  the  discretion  of  the  user. 


4.1.2  where  lore  Pa  t a jL  I M i uh  t 3e  Necessary 

If  within  the  standard,  references  are  made  to  information  that 
is  deemed  necessary  to  include  within  a certain  section,  it 
might  be  advisable  to  include  this  information  in  tne  schema. 

An  example  of  this  would  he  ir,  the  Data  Retirements  Document  of 
D.O.U,  Manual  4 123-17-M.  Ir.  this  document,  the  table  of 
contents  looks  as  follows: 

1.  GENERAL  DATA  REQUIREMENTS 

1.1  PURPOSE  O"  DATA  REQUIREMENTS 

1.2  PROJECT  REPEFFNCES 

1 . 3 MODIFICATION  OF  DATA  REQUIREMENTS 

2.  DATA  DESCRIPTION 

2.1  LOGICAL  ORGANIZATION  OP  STATIC  SYSTEM  DATA 

2.2  LOGICAL  ORGANIZATION  OF  DYNAMIC  INPUT  DATA 

2.3  LOGICAL  ORGANIZATION  OF  DYNAMIC  OUTPUT  DATA 

2.4  INTERNALLY  GENERATED  DATA 

2.5  SYSTEM  DATA  CONSTRAINTS 

3.  USEP  SUPPORT  FOP  DATA  COLLECTION 

3.1  DATA  COLLECTION  REQUIREMENTS  AND  SCOPE 
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3.2  recommend  soorcf  of  input  data 

1.3  DATA  COLLECTION  AN  0 TP  A N S F EH  PROCEDURES 
>.4  DATA  RASE  IMPACTS 

within  Section  1,1,  the  standard  refers  to  nine  areas  of 
suop  lenient  ir  y information.  If  this  information  is  considered  to 
h?  of  such  a natura  that  it  will  or  should  be  included  in  sost 
all  the  documents  h » i nu  produced,  the  user  might  mant  to  include 
the  information  in  a he  schema  (therefore  in  the  table  of 
contents  of  the  document)  . The  schema  mould  then  look  like: 

• 1,  GENERAL  DATA  REQUIREMENTS 

• 1,1  PDF  POSE  OE  DA'”  A PEQUT  FOMENTS 

*1.2  PP  0.1  ECT  REFERENCES 

*1.3  MODIFICATION  OE  DATA  PFQUTPEMENTS 

*2.  DATA  DESCRIPTION 

*2.1  LOGICAL  ORGANISATION  OF  STATIC  SYSTEM  DATA 

*2.2  LOGICAL  ORGANIZATION  OF  DYNAMIC  INPUT  OATA 

*2.3  LOGICAL  ORGANIZATION  OF  DYNAMIC  OUTPUT  DATA 

*2.u  INFERNALLY  GENERATED  DATA 

«?.S  SYSTEM  DA” A CONSTRAINTS 

*3.  USER  SUPPORT  ^OR  DATA  COLLECTIONS 

•3.1  DATA  COLLECTION  REQUIREMENTS  AND  SCOPE 

*3.1.1  INPUT  SOURCE  (S)  OF  THE  DATA  ELEMENT 

*3.1.2  INPUT  M EDIU M 

*3.1.3  RECIPIENTS 

*3.1.4  CRITICAL  VALUE 

• 3.1.S  SCALES  OF  M FAS U REMEN T 

*3.1.6  conversion  factors 

*3.1.7  OUTPUT  EOFM/DEV1CF 

• 3 . 1 . R EX  P A NS 1 ON  FACTORS 

•3.1.9  FREOUENCY  OF  UPDATE 

*3.2  RECOMMEND  SOURCE  OF  INPUT  DATA 

*3.3  DATA  COLLECTION  AND  TRANSFER  PROCEDURES 

*3.4  DAT  A BASE  I M PACTS 

Tt  might  bp  that  the  documentor  lust  needs  to  he  reminded  of  the 
supplementary  information.  In  this  case  it  might  be  appropriate 
lust  to  include  an  appropriate  comment. 

*1.  GFNERAI.  DA^A  RFOUTRFMFNTS 

*1.1  PURPOSE  OF  DATA  RFQUTR  EMFNTS 

*1.2  PROJECT  PSFFFFNCES 
*1.3  MODIFICATION  OF  DATA  R EQUT RFMENTS 
•2  DATA  DESCRIPTION 

*2.1  LOGICAL  ORGANIZATION  OF  STATIC  SYSTEM  DATA 

*2.2  LOGIC  A I ORGANIZATION  OF  DYNAMIC  INPUT  DATA 

*2.3  LOGICAL  ORGANIZATION  OF  DYNAMIC  OUTPUT  DATA 

• 2.R  INFERNALLY  GFNFRATEU  DATA 
•2.*  SYSTEM  DATA  CONSTRAINTS 

*3.  USER  SUPPORT  FOR  DATA  COLLECTION 
*3.1  DATA  COLLECTION  REQUIREMENTS  AND  SCOPE 

R AT  "HIS  POINT  IT  SHOULD  DF,  NOTICED  THAT  THERE  ARE  NINE 

AREAS  TO  BE  CONCERNED  WITH  IN  THIS  SECTION.  T H ET  ARE: 
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A.  INPUT  SOURC  E ( *5 ) OP  THE  DATA  ELEMENT 

B.  INPUT  MEDIUM 

C.  RECIPIENTS 
P.  CRITICAL  VALUE 
E.  STALES  OP  MEASUREMENT 

CONVERSION  PACTORS 

G.  DUTPUT  FORM /DEVICE 

H.  EXPANSION  FACTORS 

I.  PREOUSNCY  np  UPDATE 
FECOMM  END  SOURCE  OP  INPUT  DATA 
DATA  COLLECTION  AND  TRANSFER  PROCEDURES 
DATA  BASS  IMPACTS 

The  decision  is  to  what  should  ho  in  the  schema  is  based 
primarily  on  how  much  detail,  is  wanted  and/or  expected  in  the 
tabl e of  con  tents. 

(■ 

4.2  Peve lopment  of  the  Documentation  Jojjrco 

>« 

The  format  ot  the  documentation  source  input  an  1 a description  » 

of  how  it  in  transformed  into  the  documentation  source  is  in  ^ 

Sect- ion  2.  There  are  seven  1 areas  that  the  user  need  be  aware 
of  when  developing  the  lociinenurion  source.  Prof icieno y in 

these  areas  is  necessary  if  the  documentor  is  to  attain  full  ■ 

range  capabilities  of  the  document  generator.  !• 


4.2.1  Knowledge  of  the  Analyzer  Data  has e i 

It  is  of  utmost  importance  that,  rho  documentor  have  a thorough  ;; 

knowledge  of  the  Analyzer  data  base  as  well  as  the  Analyzer  1 

command  language.  The  documentor  must  be  able  to  pick  out  the 

information  needed  for  the  locuner.t.  When  it  is  known  that  a 

svs*era  will  have  to  be  documented  using  a certain  standard,  it 

is  also  important  that  the  person  developing  rhe  Anal yzar  data 

base  have  a full  understanding  of  what  information  is  naede;.  to 

fulfill  t.he  standard's  documentation  require  nonts.  Sice  toe 

standard  usually  requires  comelet.e  information  about  t.?  system, 

writing  the  Analyzer  data  base  with  tne  standard  in  mind  will 

usually  serve  t-i  insure  a complete  system  description. 


* 

F, 

F. 

F. 

T, 

F, 

f, 

F. 

r. 

• 3.2 
*3.3 

• 3.  4 


4.2.2  Text  M a ter  ^al 

The  documentation  source  for  various  projects  written  under  a 
certain  standard  should  be  developed  in  such  a wav  as  to 
minimize  the  differences  in  the  various  Documentation  sources. 
This  can  cut  lown  substantially  on  the  documentor's  time  spent 
on  each  system.  Another  advantage  of  doing  this  is  that  once  a 
certain  combination  of  commands  has  been  determined  as  the  best 
wav  to  convey  certain  information  required  by  a particular 
standard,  then  that  combination  can  be  repetitively  used  for  all 
orolects  documented  under  this  particular  standard. 


. 
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with  this  in  mini,  the  documentor  should  try  to  include  in  the 
source  only  such  tort  that  will  be  present  in  every  instance  of 
the  document  beinq  produced.  Examples  of  such  text  are  in 
paragraphs  found  in  both  the  Functional  Description  and  Data 
”equireaents  Documents.  These  paraqraphs  describe  the  purpose 
of  each  of  the  documents: 

Sect  ion  1. 1 

This  Functional  Description  for  (Project  Name)  (Project 
Number)  is  written  to  provide: 

a)  The  system  requirements  to  be  satisfied  which  will 

serve  as  a basis  for  mutual  understanding  between 
the  user  and  the  developer. 

b)  Information  on  performance  requirements,  preliminary 

desiqn,  and  user  impacts,  includinq  fixed  and 
continuinq  costs. 

c)  A basis  for  the  development  of  system  tests. 


Section  1.2 

The  objectives  of  this  Data  Requirements  Document  for 
(Project  Name)  (Project  Number)  are  to  list  and  define  data 
elements  which  the  system  must  handle  and  to  communicate 
data  collection  requirements  to  the  user. 

Another  examples  of  where  text  should  be  used  is  when  a common 
portion  of  the  document  is  beinq  described.  An  example  of  this 
is  Section  3.3  of  the  Functional  Description.  Sere  is  an 
example  of  how  the  source  might  look: 

1 3.  3 IN  PUTS /OUTPUTS 
INPUTS  : 

n;ng  S=’ INPUT’ 

"AFP  S 
♦SKIP  2 

OUTPUTS  : 

S= ’OUTPUT  OR  INPUT’ 

*FPS 

tSTP  OUTPUT 

FLnce  the  documentation  source  data  base  will  be  different  for 
each  project  documented,  it  is  not  necessary  that  the  taxt  be 
constant.  However,  this  practice  reduces  redundancy  in  work 
done  by  the  documentor. 
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As  mentioned  before,  the  documentor  must  have  a full 
unde  rstandi  a g of  th=»  Analyzer  command  capabilities  (des~ribed  in 
Part  TV*)  including  all  possible  options.  Thus  knowledge  is 
essential  far  the  document  generator  to  produce  complete 
information  in  a r»adihle  form.  Some  of  the  commands  aid 


options  that  might 

be  useful 

are  listed  below: 

PCCH 

o pt.ions: 

DF.SCR  IPTION 
NOPUNCFf 

NG 

Opt  ions: 

BUBLEVFL=  # 
SUBPAP",-0E  = NA«1E 
NOPRTNT, PRINT 
KEY=keyvord-name 

CON'f’FNT’S 

PICTURE 

0 pt  i on' . : 

NODATA 

NOFI.O  « 
NOSTRUCTURE 

Th®  Data  Process  Keoort  could  bo  very  non  ; uUl,  especially 
since  it  produces  a very  complete  description  of  data  flow  and 
process  functions.  It  can  be  u.-ien  when  an  overall  interaction 
description  is  needed.  This  report  ai  .<>  snows  it  consistency  is 
present  as  well  showing  completeness  (or  incompleteness). 

The  STOP  command  should  not  be  used.  There  are  three  options  of 
the  SFT  command  that  should  not  be  used:  PFOHPT-ON  will 
virtually  destroy  the  document  being  produced.  It  is  also 
recommended  that  OfiTPUT  = XXX,  Id  FA  DI  NG=ON,  PARM=ON  not  be  used. 
(All  four  of  these  options  default  to  OFF.) 


* Part  Tv,  "User  Requirements  Analyzer  Command  Description.* 
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9.2.4  Format t ing  pntc jes 

's  shown  in  Section  2.2,  the  text  formatting  entries  allow  the 
user  a great  deal  of  maneuverability  in  regards  to  the  final 
document  format.  At  this  point,  a diagram  might  help  to  show 
lust  what  is  going  on  a page  of  a document. 


top-1 ines 


LINES 


bottom- 
1 ines 


Tt  is  important  for  the  documentor  to  understand  the  formatting 
commands.  There  ar?  several  points  that  should  be  remembered 
when  using  the  commands.  These  are  covered  in  the  following 
subsection. 


4. 2. 4.1  Pef a u It  § of  F or ma  t ti ng  Commands 

Th“  formatting  options  can  be  changed  at  any  time  in  the  Source, 
"h*  formatting  commands  defaults  affect  how  the  document  will 
apDear.  If  one  dops  not  specify  a value  for  these  commands, 
then  the  default  will  be  used.  When  the  documentor  does  not 
specify  these  command  values,  then  the  final  document  will 
appear  as  if  the  defaults  were  included  in  the  Source  data  base. 
The  formatting  command  defaults  are: 
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H 


* FFPORT-CC  ON 

* TITLE  OFF 

* HFADING  ON 

* TOP-LINES  3 

* 90TT0M-LI  NFS  2 

* LINES  60 

* SOURCE-MARGIN  5 

* HEADING-MARGIN  6 

* II  FADING-S  KT  P 2 

The  last  occurrence  of  each  ootion  is  the  one  in  eff-rt.  The 
formaMinq  cominds  in  the  Source  loqicaLly  succeed  the  commands 
in  the  Schema  and,  thus,  override  Schemi  commands  at  the  time 
they  are  encountered  in  the  Source. 


4.2. 4.2  Anal yzec  Regoi.t  Indentation 

Analyzer  report  identation  is  not  affected  by  either 
HE  A D ING- MAP  G I N or  SOURCE-MARGIN.  Care  must  be  ti<en  ir.  setting 
these  two  options  so  the  document  being  pit  lured  is  in  i loqical 
readible  format  and  fits  on  the  size  of  paper  desired. 

4. 2.  4.  3 LIN^  SKIPPING 

HEADING-SKIP  reacts  the  same  way  as  SKTr  loes  wuen  an  end  of 
paqe  is  encountered.  Also,  the  documentor  should  be  careful 
when  tryinq  to  set  up  a section-header  so  it  starts  on  a new 
paqe.  Tf  the  value  of  SKIP  or  UFA  TER-SK IP  is  more  than  the 
current  LINES  values  then  the  qenerator  automatically  snips  to 
the  ton  of  the  next  page. 


4.2.  4.4  Hsacje  of  RFPORT^CC 

The  REPOPT-TC  command  specifies  whether  to  use  the  Analyte. 
REPORT  Carriaqe  Control  symbol  s or  to  :■  u p press  them.  ?S?ORT-CC 
ON  means  that  the  normal  carriaqe  control  for  he  Analyter 
reports  will  be  used.  OFF  jeans  that  they  will  be  suppressed 
and  the  usual  paqinq  sequence  will  be  used. 

Usaqe  of  the  RFPORT-CC  commanl  will  have  a diieet  bearing  on  the 
paqinq  of  the  document  being  processed.  Since  when  REP3RT-CC  is 
ON,  analyzer  reports  will  be  produced  accordinq  to  theic  normal 
paqi nq  sequence.  This  is  helpful  when  a PICTURE  Report  is  being 
produced  and  more  than  one  name  is  input  or  the  PICTURE  must  be 
continued  on  the  next  paqe.  3th*»r  reports  where  this  option  is 
helpful  are  the  DAM-PROCESS  Repoct  and  the  CO  NR  I S IS  - COM  PA  RI  SON 
Report.  In  cases  where  a report,  will  be  talcinq  up  more  than  ona 
paqe,  it  is  important  to  start  the  report  at  the  i >p  of  a flesh 
Daqe  so  that  the  Ana lvzei  paqinq  will  match  the  iocument at  ion 
qenerator's  paqinq.  There  are  cases,  though,  where  the 
documentor  will  wish  to  set  REPORT-CC  off,  such  as  where  several 
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names  are  being  entered  into  the  "PS  Report  or  30NTENTS  Report. 


4.2.  4.  S The  HOLD  and  ilQL02l?kM£  Commands 

The  documentor  should  understand  the  usefulness  of  the  HOLD  and 
HOLD-BLANK  commands.  If  a diagram,  table  or  figure  must  be 
drawn  manually,  the  HOLD-BLANK  command  should  always  be  used. 
This  will  insure  enough  space  is  saved  on  one  complete  page  to 
insert  the  fiqure.  If  an  analyzer  report  or  some  text  material 
is  gcing  to  be  produced  and  the  documentor  wishes  that  this 
material  he  contained  on  one  page,  the  HOLD  command  should  be 
used.  An  example  of  where  it  would  be  used  is  with  the  PICTURE 
Report..  Since  the  PICTURE  Report  uses  41  lines,  the  documentor 
should  place  a HOLD  41  preceding  the  PICTURE  command  to  insure 
tha*  it.  is  produced  on  a single  page. 


4.2.  B Usage  of  Analyzer  SYNONYMS 

A SYNONYM  is  a short  abbreviation  form  of  a name  that  can  be 
stored  in  the  Analyzer  data  base.  A SYNONYM  is  a reserved  word 
of  the  Analyzer. 


In  order  to  generalize  the  documentation  Source  data  base, 
SYNONYMS  should  be  osed  whenever  possible  to  describe  certain 
items,  such  as  main  functions,  master  files,  etc.  The 
implication  of  this  practice  on  the  Analyzer  data  base 
formulation  is  discussed  in  section  4.3.2. 

By  usina  SYNONYM  5 , the  documentor  is  relieved  of  changing  even 
more  of  the  Source  data  base  from  one  project  to  the  next.  An 
example  of  how  this  can  be  done  is  in  section  3.2  of  the 
Functional  Description.  The  Source  data  base  will  look  as 
f oil ows: 


♦3.2  SYSTEM  FUNCTIONS 

<NG  S='MAIN-PROCFSS  AND  SL=1' 

THE  VARIOUS  SU  B- FUNCTIONS  OF  THE  SYSTEM  ARE: 
% PCOM  DFSC  PRCD  NCPUNCH 


Tn  this  example  MAIN-PROCESS  is  a SYNONYM. 
Section  2. 4.  2. 4 is  another  example. 

*2. 4. 2. 4 OPERATIONAL  IMPACTS 

A.  OPERATIONAL  STRUCTURE 

«STR 
♦SKIP  2 

B.  ""TMELINESS  (OPERATIONS  AND  DATA) 

HFRFQ 
♦SKIP  2 

r.  INPUTS 
VSTR  INPUT 
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♦SKIP  2 

0.  DATA  RETENTION 
1.  MASTER  PILE 

VPCON  N - MASTER  - PILE  DESC  DER  NOPUNCH 
♦NEW-PAGE*' 

*PIC  N*  MASTER- PJLf  NODATA  NOFLOW 
Here,  MASTER-PILE  is  a SYNONYM. 


U.3  Development.  of  the  Analyzer  Data  Base  with  the  Document 
££fle£ator  in  Mind.* 

There  are  two  situations  that  can  occur  in  relation  to  the 
Analyzer  data  base  when  using  the  Document  Generator. 

The  Analyzer  data  base  has  either  been  written  with  the  document 
to  be  produced  in  mind,  or  it  has  not  been.  In  any  case,  it  is 
going  to  be  beneficial  for  the  documentor  to  write  or  update  the 
Analyzer  data  base  in  such  a way  as  to  facilitate  ease  of 
production  of  the  document  using  the  generator.  Various 
practices  can  be  used  by  the  documentor  to  accomplish  this. 

These  practices  are  explained  in  the  following  subsections. 


4,1.1  Usage  of  MEMO 

When  it  is  aecessary  to  describe  certain  aspects  of  a pronsed 
system  that  are  general  in  nature  but  do  not  apply  directly  to 
the  structural,  functional,  or  data  flow  of  the  system,  then  the 
usage  of  MEMOS  in  the  Analyzer  data  base  can  be  vecy  helpful. 
When  objectives,  background  material,  reguireaents,  impacts, 
etc,,  are  needed,  a MEMO  is  the  obvious  answer.  Hence,  simple 
PUNCH-COMMENT-ENTRY  is  all  that  is  needed  in  the  documentation 
source.  An  examplp  of  a typical  MEMO  is  shown  below.  This  MEED 
relates  the  objectives  required  for  Section  2.2  of  the 
Functional  Description: 

"EMO  OBJECTIVES- MEKD ; 

DESCP IPTION; 

THIS  PROJECT  HAS  BEEN  AUTHORISED  TO  DEVELOP  A PAY  SYSTEM 
FOP  THIS  ORGANIZATION.  THIS  PAY  SYSTEM  WILL  PERFORM 
PAYROLL  PROCESSING  USING  EMPLOYEE  INFORMATION  COMING  PROM 
DEPARTMENTS  AH D EMPLOYEES  AND  WILL  PRODUCE  OUTPUTS  WHICH 
WII.L  GD  TO  THE  DEPARTMENTS  AND  EMPLOYEES.  THE  SYSTEM  WILL 
ALSO  MAINTAIN  THE  PAYROLL  MASTER  INFORMATION. 


4.3.2  Usage  gf  NAMES  and  SYNONYMS 


1 Note:  All  capitalized  nam-'s  in  this  section  refer  to  3 RL 
Reserved  Words.  ’’•or  a more  detailed  explanation,  refer  to  Parts 
I and  II  of  the  URL  User’s  Manual. 
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when  the  documentor  or  analyst  is  constructing  Analyzer  data 
bases,  one  should  keep  in  mind  what  Analyzer  NAMES  and  SYNONYMS 
have  been  used  in  previous  documentation  source.  The 
documentor's  work  can  be  reduced  if  common  names  are  ussd  to 
describe  similar  sections  of  Analyzer  data  bases  which  are 
describing  systems  that  will  have  to  be  documented  under  the 
same  standard.  For  instance,  a documentor  might  want  to  includa 
sections  called  BATKG  ROUND- NEMO  and  OBJECTIVE-MEMO  when 
developing  Analyzer  data  bases  to  be  documented  using  the 
Functional  Description  Standards.  The  documentor  might  also 
want  to  have  an  ATTRIBUTE  named  DEVELOPMENT-TIMES  in  thsse  Data 
sases.  An  example  of  ATTRIBUTE  usaqe  follows: 

DEFINE  DEVELOPMENT-TIMES 


AS 

A ATTRIBUTE; 

VALUFS  ARE: 

MAN-H0URS-12C 

"OR 

PROGRAMMING, 

PLENTY  FOR 

MAN- HOUR S- 1 D 0 

COMPUTER-TIME, 

tOR 

MAN- HOURS-23 

DATA- BASE- DEVELOPMENT, 

"OR 

MAN- HOURS-33 

PAYROLL-CLERICAL, 

FOR 

* / 

OPERATIONS, 

SYNONYMS  can  be  use!  in  similar  fashion.  If  the  documentor  uses 
similar  synonyms  in  each  data  base,  his  editing  can  be  reduced. 
Examples  of  this  are  usinq  M ASTER- FILE  as  a SYNONYM  for  the  main 
file  of  th°  system  and  using  MAIN-PROCESS  as  a synonym  for  the 
hiqhest  level  function  in  the  system. 


<J.3.3  Completeness 

?hare  are  three  areas  in  which  the  documentor  or  analyst  should 
strive  to  achieve  completeness  in  the  Analyzer  data  base.  These 
areas  are  data  flow,  system  structure,  and  functional  flow. 

Data  flow  should  be  complete  in  that  all  files  or  data  sets  are 
accounted  for.  This  means  that  data  definition  should  be 
included.  Elements  of  data  sets  need  be  defined  only  to  the 
level  of  description  required.  The  CONTENTS  Report  is  a qood 
means  of  checkinq  data  description  completeness.  Usaqe  of 
UPDATES,  DERIVFS,  GENERATES,  RECEIVES,  and  USES  statements  is 
the  vehicle  by  which  data  flow  information  is  presented. 

System  structure  must  be  complete  for  obvious  reasons.  The 
STRUCTUPF  Report  is  helpful  in  checkinq  and  representing  the 
informat  ion. 

Functional  flow  is  perhaps  the  trickiest  facet  in  the 
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development,  of  the  Analyzer  data  base.  Care  must  be  tax  en  to 
insure  that  a functional  chain  of  EVENTS,  CONDITIONS  and 
PROCESSES  exists  in  a raeaingful  fashion.  Usage  of  TRIGIERS,  ON 
TERMINATION  OP,  ON  INCEPTION  OP,  TRIGGERS,  HAPPENS,  and  WHEN 
statements  is  suggested.1 


4.  3.  4 DESCRIPTIONS 


'"he  documentors  should  Keep  in 
will  need  descriptions  in  tho  f 
of  systems.  The  DESCRIPTION  st. 
documentor  to  meet  these  text  r 
should  include  a DESCRIPTION  vi 
Analyzer  data  base,  as  veil  as 
that  are  deemed  necessary  (i.e. 
etc.  ) . 


min 

d that  in 
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cases  s 

ta 
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of  text 
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as 

poets 

ate 

aent  can 

be  us 

ed  by  th 
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to 

r 

th 

all  aa  jor 
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an 
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other  de 

scrip 

tive  sta 

te 

aent  s 

, P 

ROCEDURE, 

VOLA 

TILI TI-SET 

9 

4.3.*  Us a K EYVOf DS 

When  one  or  more  ob-jects  in  a system  description  need  to  be 
identified  for  selection  an!  analysis  purposes,  KEYWORDS  should 
be  attached  to  each  of  the  objects.  Ry  doing  this,  the 
documentor  has  a link  between  related  objects.  Por  example,  if 
ail  functions  (PROCESSES)  described  as  being  manual  procedures 
in  a system  description  were  to  be  listed  and  analyzed  together, 
the  KEYWORD  "manual"  could  be  attached  to  each  PROCESS  for  this 
DurDose.  Ry  doing  a NAME-GEN  vith  the  option  KE Y *MA  N UAL , a list 
of  these  PROCESSES  could  then  be  produced. 


1 See  Part  I foe  an 


exp la  not  ion  of  these  terms. 
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This  appendix  presents  all  UFA  commands,  with  their  parameters 
and  defaults.  It  also  presents  the  acceptable  abbreviations  for 
these  commands  and  parameters.  There  are  several  conventions  in 
choosing  these  abbreviations  that  say  aid  the  user: 


For  comand  names  that  consist  of  only  one  word,  for 
example,  CONTENTS  or  PICTURE,  the  first  three  or  four 
letters  of  the  name  are  used  as  their  abbreviation.  CONT 
is  the  abbreviation  for  CONTENTS  and  PIC  is  the 
abbreviation  for  PICTURE. 


Eor  most 


abbrevi a 
word  in 
CONSISTS 
This  con 
the  abbr 
DCOM  is 


more  mne 


comman 

NSISTS- 
tion  is 
the  com 
-MATRIX 
vent  ion 
eviatio 
the  abb 
monic  t 


d names  that  consist  of  more  than  one  word, 
MATRIX  or  FORMATTED-PFOBLEH-STATEMENT,  the 
derived  by  using  the  first  letter  from  each 
wand  name.  This  gives  CM  for 
and  PPS  for  FORM ATT ED- PROBLEM -STATE  ME  NT. 
is  not  strictly  followed  however,  so  that 
ns  may  he  more  meaningful.  For  eraiple, 
reviation  for  DELETE-COHM ENT-ENTR Y which  is 
han  DCE . 


Abbreviations  for  parameters  used  in  the  same  way  by 
several  commands  are  the  same.  The  FILE  parameter  then, 
always  has  an  abbreviation,  F,  allowed  no  matter  which 
command  is  using  it.  Some  of  the  more  common  parameters 
are  listed  below: 


Parameter 


Abbreviation 


FT  LF 


NAME 


INPUT 


NOPRINT 


PUNCH 


Whenever  an  aboreviation  exists  for  u parameter  that  has  a 
"NO"  prefix,  such  as  NjPRINT,  the  abbreviation  is  always 
prefixed  with  " N " . For  example,  NP  is  the  abbreviation  for 
NOPRINT . 


A blank  entry  in  the  "Parameters"  column  for  a command 
designates  that  there  are  no  parameters  for  the  command.  A 
blank  entry  in  the  "Abbreviations"  column  designates  that  there 
is  no  abbreviation  for  the  command  or  parameter  name.  A blank 
entry  in  the  "Defaults"  column  designates  that  there  is  no 
default  for  this  parameter  for  the  given  command. 
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Command  Name 

Parameters 

Abbreviations 

ts 

CHANGE-TYPE 

CT 

FILE 

F 

NAME 

N 

TYPE 

T 

CON STSTS-COM PARI  SON 

FILE 

CNC 

F 

FILE 

CONS  I STS -MAT FIX 

CM 

FILE 

F 

FILE 

NAME 

N 

CONTAINED 

CNTD 

CONSISTS 

CSTS 

CONTENT?  CONT 

PILE  F 

NAME  N 

INDEX 

NOINDEX 

LEVELS 

NCFLAG 

NONCF  LAG 


DATA-PROCESS  DP 


FILE 

NAME 

DATA 

PROCESS 

DPMAT 

NODPHAT 

DPANL 

NODPANL 

PM  AT 

NOPHAT 

PANL 

NOPANL 

F 

N 

D 

P 

FILE 

DPMAT 

DPANL 

PH  A T 

PANL 

DELETE 

DEL 

FILE 

F 

NAME 

N 

DELETE-COMMENT- ENTRY 

DCOM 

DESCRIPTION 

DESC 

NODESCRIPTION 

NDESC 

NOD ESC  RI PTION 

DERIVATION 

DER 

NODERIVATION 

NDEP 

NODERIVATION 

FALSE-WHILE 

FW 

NOFALSE- WHILE 

NEW 

NOFALSE-WHILE 

PROCEDURE 

PRCD 

NOPFOCEDURE 

NPRCD 

NOP  ROC  EDURE 

TRUE- WHILE 

TW 

Appendix 

A UFA  Command 

Abbreviations 

FILE 

NOINDEX 
LEV  ELS  = A LL 

NDNCPLAG 


r 
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Nnnu.il 

2<H 

. 

NOTRUE-WHILE 

NTW 

N3TRUE-WHI LE 

VOLATILITY 

VOL 

NOVOLATILITY 

NVDL 

NDVOLATr  LITY 

VOLATILITY-MEMBER 

VOLN 

NOVOLATILITY- 

NVOLH 

NOVOLATI  LITY- 

MEMBER 

MEMBER 

VOLATILITY-SET 

VOLS 

novolatility-set 

NVOLS 

NOVOLATILITY- 

SET 

! 

El  LF 

F 

NAME 

N 

1 

PPINT 

PRINT 

t 

NOPRINT 

NP 

( 

DELF^-PSI. 

DPS  L 

| 

INPUT 

I 

TNPUT=t(*rmin.\l 

soufc* 

s 

SOURCE 

NOSOURCE 

NS 

X PEP 

X 

A 

j 

NOXREF 

NX 

NOX  REP 

* * 

I 

DICTIONARY 

DICT 

•1 

PTLE 

F 

PILE 

1 

NAME 

N 

I 

INDEX 

NOINDFX 

NOINDEX 

NUN-SPACE 

NS 

Nil  M - SP  AC  E*2 

4 

ofscrtptton 

DESC 

DESCRI PTION 

NODES  C” I PTT  ON 

NDESC 

KEYWORDS 

KEY 

KEYWORDS 

NOKFY WORDS 

NKEY 

- 

»‘s 

rfsponstrlf-pd 

RPO 

RES  PON  STOLE- PD 

1 

N ORES  PO  N SI  RI.E-  PD 

NRPD 

SYNONYMS 

SYN 

SYNONY  NS 

NOSYNON YNS 

NSYN 

3 

ENTITY-IDENTTFTFR 

El 

'i 

PILE 

F 

PI  LE 

NANE 

N 

i 

IDENTIFIER 

I 

i 

ENTITY 

E 

s 

EX'TNDFT' -PIC  TURF 

EP 

FILE 

F 

PILE 

NANF 

N 

] 

* - INDEX 

NOINDEY 

NOINDS  X 

i 

STRUCTURE 

STR 

DATA-FLOW 

DF 

t 

FORWARD 

FWD 

RACKW ARD 

PWD 

DOWNWARD 

DOWN 

UPWARD 

UP 

\ 

LINES 

LI  NK S* 1*00 
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COLUMNS 

ROWS 

HORIZONTAL-BOXES 
VERTICAL- BOXES 

COLS 

HB 

VB 

COLUMNS*  119 
ROWS-39 

FORM ATTE  D-PRO  BLEM-ST  A TEH ENT 

EPS 

ALL- STATEMENTS 

AS 

AS 

NOALL-STATEMENTS 

NAS 

AMAR3 

AM 

AMARG* 10 

BMAR3 

BM 

BMARG*  25 

COMMENT 

COM 

COMMENT 

NOCOMMENT 

NCOM 

COMPLEMENTARY- 

COMP 

COMP 

STATEMENTS 

NOCOMPLEMENTARY- 

NCOM  P 

STATEMENTS 

CHAR  3 

CM 

CNARG=  1 

DEPIN  E 

DEE 

OEEINE 

NODEFINE 

NDEE 

DESG 

DG 

DESG 

NODESG 

NDG 

EMPTY 

NOEMPTY 

FILE 

F 

FILE 

NAME 

N 

HM  AR3 

HM 

HM ARG- 40 

INDEX 

NOINDEX 

NOINDEX 

line-numbers 

LNS 

LNS 

NOLINE-NUMBERS 

NLNS 

NEW-LINES 

NL 

NONEW-L IN  ES 

NNL 

N3NEW-  LINES 

NFW-PAGE 

NPG 

NONEW-PAGE 

NNPG 

NONEW-  PAGF 

NMAR3 

NM 

NN  ARG*  20 

ONE-PER-LINE 

OPL 

ONE-PER-LINE 

SEVER  AL-PER-LINE 

SPL 

PRTNT 

PRINT 

NOPRI NT 

NP 

PRINT  OF 

PEOP 

PEOF 

NOPRI  NT  OE 

NPEOE 

PUNCH 

P 

NOPUNCH 

NOPUNCH 

PNHAPG 

RM 

RNBAR3  =70 

SNAR3 

SH 

SNA  RG*  5 

PREOUENCY 

FREQ 

H PL  P 

command-name 

SHORT 

SHORT 

LONG 
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TNPUT-PSL 

IP 

DBREF 

D 

DBREF 

NODBRFF 

ND 

INPUT 

I 

INPOT»t*ri»inai 

SOURCE 

NS 

SOURCE 

NOSOURCF 

S 

UPDATE 

U 

NOUPDATE 

NU 

NOUPDATE 

XREF 

X 

NOXREE 

NX 

NO  XREF 

KWIC 

FILE 

F 

FILE 

DIF 

DI  P*2 

NANF-GEN 

NG 

EMPTY 

NOEMPTY 

ORDER 

ORDER*  BY  TYPE 

apiVT 

PRINT 

NOPHI NT 

NP 

PUNCH 

P 

PUNCH 

NOPUNCH 

SELECTION 

S 

INPUT 

I 

HANF=TIST 

NL 

ORDER 

ORDER-  ALPHA 

PICTURE 

PIC 

DATA 

D 

DATA 

NODATA 

ND 

PILE 

F 

PILE 

NAME 

N 

FLOW 

FLOW 

NOFLOW 

INDEX 

NOTNDEX 

NDINDEX 

STRUCTURE 

STR 

STRUCTURE 

NOSTRUCTURE 

NSTR 

PRINT-ATTRIBUTE-  VALUES 

PAV 

FILE 

F 

FILE 

NAME 

N 

PROCESS-CHAIN 

PC 

FILE 

F 

FILE 

NAME 

N 

INDEX 

hOINDEX 

NOINDEX 

LINKS 

LINKSOOOO 

COLUMNS 

COLS 

C01UME S-11 W 
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ROWS 

1 

R3WS*39 

HORIZONTAL-BOXES 

HB 

VERTICAL-BOXES 

VB 

PPOC  ESS- INPUT -OU  T PUT 

PRIO 

PILF 

F 

PILE 

NAME 

N 

DESCRIPTION 

DESC 

DESCRIPTION 

NO DESCRIPTION 

NDESC 

PROCEDURE 

PRCD 

NOPR3CEDUR  E 

NPRCD 

NOPROJEDURE 

INPUT 

INP 

INPUT 

NOINPUT 

N IN  P 

OUTPUT 

OUT 

OUTPUT 

NOOUTPUT 

NOOUT 

NEW- PAGE 

NPG 

NONFW-P AGE 

NNPG 

NONEW-PAGE  * 

PRINT 

PRINT 

NOPRINT 

NP 

| 

INDEX 

1 

NOINDEX 

NOINDZX 

PUNCH -COMMENT -ENTRY 

PCOM 

DERIVATION 

DER 

NODER IV ATION 

NDER 

NDDERI VATION 

DESCRIPTION 

DESC 

NODESCR I PTION 

NDESC 

NODES! IR PTION 

PALSE-WHILf 

FW 

NOFAL  SE-WHILE 

NFW 

N3PALSB- WHILE 

PROCEDURE 

PRCD 

NOPORCEDURE 

NPRCD 

NOPROI ED  URE 

TRUE- WHILE 

TW 

NOTRHE- WHILE 

NTW 

NOTRUE-WHILE 

VOLATILITY 

VOL 

NOVOLATILITY 

N VO  L 

NOVOLATILITY 

VOLATILITY-MEMBER 

VOLH 

NOVOLATILITY- 

NVOLM 

NOVOLATILITY- 

MEMBER 

HEMBBR 

VOLATILITY-SET 

VOLS 

NO VOL ATI  LIT Y- SET 

EMPTY 

NO  EMPTY 

NVOLS 

NOVOLATILITY- 

SET 

PILF 

F 

FILE 

NAMF 

N 

PRINT 

PRINT 

NOPRINT 

NP 

PUNCH 

P 

NOPUNCH 

NOPUNZH 

SECURITY-CONSISTENCY  ANALYSIS 

SECA 

PESO URCS-CON SUMPTION -ANALYSIS 

RCA 
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RENAME 

REN 

INPUT 

I 

OLD 

0 

NEW 

N 

REPLACE- COMM  ENT -ENTRY 

INPUT 

RCON 

I 

INPUT 

PRINT 

NOPRI NT 

NP 

PRINT 

STRUCTURE 

STR 

INDENT 

INDEX 

IND 

INDENT-3 

NOTNDEX 

INPUT 

INP 

NOINDEX 

INTERFACE 

TNTF 

OUTPUT 

OUT 

PROCESS 

PRDC 

PROCESS 

REAL-WORLD- 

ENTITY 1 

RWE 

PROCESSOR 

PRCR 

SMEM  ARY 

sun 

» RE  AL- WORLD -ENT  ITY  is  synonyaous  sith  INTERFACE  (INTF). 


Appendix  A UFA  c>>amand  Abbreviations 


H6180/Hultics/UFA  User's  Manual 


303 


CREATING  A MD  INITIALISING  UFA  DATA  EASES 
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Refore  the  user  can  add  inforaation  to  a (IRA  data  base,  the  data 
base  aust  exist  and  be  initialized  properly.  Creating  an 
initialized  data  base  in  the  user's  working  directory  is  a 
siaple  one-step  process.  The  user  should  type 

ec  >■  1 >CARA>ini tdb  (naae)  (size) 

The  size  paraaeter  is  optional  and,  if  given,  should  be  the 
desired  size  of  the  data  base,  chosen  froa  those  sizes  presently 
available.  The  default  size  if  not  given  is  20.  The  naae 
paraaeter  is  also  optional  and,  if  given,  is  the  naae  that  ORA 
will  use  to  reference  the  data  base.  Note,  a suffix  of  .dbf 
should  rot  be  niven  hy  the  user.  The  default  naae  used  if  naae 
is  not  given  is  ura.  If  the  size  paraaeter  is  to  be  used,  then 
the  naae  aust  also  be  given. 
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Dun  p 

To  produce  a cirl  image  dump  of  a data  base: 
ec  >ml>CAFOduap  data-base  output  punch 
where: 

data-base  is  the  data  base  to  be  dumped  (the  "»dbf" 
qualifier  is  added) 

output  is  a printed  listing  of  the  dump 

Dunch  is  the  card  image  dump  segment 

Restore 

To  restore  a previously  dumped  data  base: 
ec  >ml>CARA >res t ore  data-base  output  input 
where: 

data-hase  is  an  empty  initialized  data  base  (the  dbf" 
qualifier  is  added) 

output  is  a printed  listing  of  the  input 

\ v 

input  is  the  punch  sequent  from  pdum 

Data  Base  Statistics 

To  produce  a statistics  report  of  a data  base: 

ec  >m)>CAPA>dbs  data-base  output 

where: 

data-hase  is  the  data  base  for  the  statistics  report  is 
desired. 

output.  is  a printed  listing  of  the  statistics  report 

Specification  Generator 

To  execute  the  specification  generator: 

ec  >ml>CARA>spg  schema  source 

where: 

schema  is  the  segment  containing  the  schema 
source  is  the  segment  containing  the  source 
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UR*  Info 

To  obtain  a short  suesary  of  ORA  instructions  while  using  a 
terminal : 

pr  >«l>CARA>ura_info 
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»ny  problems  arising  from  the  use  of  UFA  software  should  be 
reported . 

Problems  may  be  reported  while  using  Multics  interactively  by 
issu ing: 

■ail  * Wizard. CARA 


> message 


The  messaqe  should  contain: 

1,  your  name 

2,  your  person  id 

3,  your  project  id 

а.  the  date 

S the  data  base  you  were  workinq  with 

б.  the  command  you  were  using 

7.  a short  explanation  of  what  happened 
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USING  THE  URA  C3BMAND 
(Version  3.2 


LANGUAGE  WITH  NULriCS 
of  URA) 
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APPENDIX  E 

Tor  Using  the  UR  A Command  Lanquage  with  Multics* 

(Version  3.2  of  UFA) 

""his  appendix  summarizes  the  specific  intonation  that  a user 
must  have  in  order  to  use  the  Analyzer  in  a .Multics  environment, 
""his  appendix  consists  of  several  sections: 

1)  u P A Control  Commands  for  Multics 

DISPLAY  command 
HELP  command 

"phe  HELP  command  has  been  expanded  and  improved  for  Multics 
users.  "’’he  revised  command  description  is  included  here. 

MTS  command 
SET  command 
STOP  command 

*"hese  commands  can  be  used  when  using  URA  under  Multics  (in 
addition  to  the  other  commands  presented  in  ISDOS  Working 
^aper  No.  31). 

2)  Data  Set  Naminq  Conventions  *or  Multics 

2.1  Naming  the  Data  Base  File 

2.2  Naming  Temporary  Data  Sets 

^hls  section  describes  what  naming  conventions  should  be 
followed,  and  what  the  Analyzer  does  to  enforce  the 
con  ven  t i ons . 

1)  Notes  on  Executinq  URA  under  Multics 

3.1  Creating  and  Initializing  URA  Data  Bases 

3.2  Executing  the  Analyzer  under  Multics 

3.3  Example  URA  session 

U)  Multics  Default  Data  Set.  Names 

mhis  part  presents  the  default  data  set  names  used  by  the  URA 
commands  and  referenced  by  ISDOS  Working  Paper  No.  9*. 

S)  Multics  Glossary 


c 

\ 

h 

• J 


1 por  a better  understanding  of  Multics  see  the  Multics 
Programmer's  Manuals.  For  a more  detailed  explanation  of  how 
ura  interacts  with  Multics,  see  ISDOS  Working  Paper  Mo.  108 
(Version  3. 1 /Multics  R3.1). 
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1 Koto  on  Version  3.2  of  HRA 


"here  are  sovonl  Important  changes  that  have  been  Bade  in  tl R A 
which  makes  Version  3.2  different  than  Version  2.1. 

virst,  several  internal  modifications  (which  are  transparent  to 
fho  \iser)  have  been  made  to  make  the  HRA  more  efficient. 

Second,  a fow  errors  in  Version  2.1  have  been  corrected  so  that 
the  llRA  commands  perform  properly.  Third,  the  availability  of  a 
select  number  of  ora  commands  and  parameters  have  been  removed. 
Last,  some  new  commands  a re  available  in  this  version,  and  some 
commands  have  additional  parameters  not  available  in  Version 

**  i 

""he  following  is  a list  of  all  modifications  that  fall  Into  the 
latter  two  classes  of  changes; 

1)  The  Name  Generation  command  has  been  modified  to  permit 
retrieval  of  all  names  identified  by  a boolean  expression 
containing  the  characters  t (or),  B*  (and),  (not),  and 
either  key w oris,  attributes,  or  attribute  values. 

2)  The  Help  command  provides  either  short  or  long  explanations 
of  all  u*> A commands  an)  stand-alone  utilities. 

1)  Some  parametei  a have  changed  for  the  Set  command,  and  there 
vs  a new  command  Display  to  ('tint  the  values  of  the  Set 
parameters.  See  the  appendix  for  the  description  of  these 
commands. 

41  Additional  parameters  are  available  for  the  pps  Coxmand  to 
control  the  content  and  format  of  the  print  and  punched 
out  put . 
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Command:  DISPLAY  Type:  control  command 

Purpose:  To  display  the  current  settings  of  the  global 

switches  and  parameters. 

Prototype:  DTSLAY(DIS)(  parameter  ]. . . 


Parameters: 

ALL  Default:  no  default 

others  (see  below) 


when  the  ALL  parameter  is  given,  the  values  of  all 
the  global  switches  and  parameters  are  printed  at  th 
terminal  (in  interactive  mode),  or  on  the  line 
printer  (in  batch  mode)  . The  parameters  printed  are 
those  given  in  the  set  command  description. 


W h en  any 
current 
comma  nd 
the  SET 
fu net  ion 
command 


of  the  following  parameters  are  givan,  the 
value  associated  with  it  is  given.  This 
only  displays  the  value  of  the  paramaters: 
command  is  used  to  change  their  valuas.  The 
of  each  parameter  is  given  in  the  SET 
description. 


data-base  (db) 
echo  (e) 
heading  ( h) 
lines  (1 ) 
output  (o) 
pa  rameters(parm) 
problem-name  (pnam) 
prompt  ( p) 


Fxamples:  DISPLAY  ALL 

DIS  DB  ECHO  0 
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Command:  HFLP* 

Purpose:  To  provile  the  on-line  user  with  a list  of  possible 

commands  for  URA  or  information  about  the  parameters 
for  a particular  URA  command. 

Prototype;  HELP  [parameter]... 

Para  meters: 

Command-name  Default:  (See  text) 

Tf  no  command-name  is  given,  a list  of  currently 
available  URA  commands  and  utilities  is  given.  If  a 
command-name  is  given,  then  the  parameters  for  that 
command  are  presented.  Abbreviations  for  the 
command-name  are  also  acceptable. 

Tf  a utility  name  is  given,  such  as  DUMP  oc  RESTORE, 
then  the  description  of  the  Multics  commands 
necessary  to  execute  the  utility  is  presented. 
Abbreviations  are  PDUfi  and  PRES. 

FTL^s  Default:  (See  text) 

Tf  this  parameter  is  given,  a list  of  the  default 
data  set  names  for  the  Nultics  installation  is  given. 

SHORT,  LONG  Default:  SHORT 

If  SHORT  is  given,  only  the  parameters  for  the  given 

command  are  printed.  If  LONG  is  given,  explanations 
of  the  various  parameters  are  also  printed. 

Examples:  HELP  FPS  LONG 

HELP  FILES  SHORT 


1 This  command  has  been  improved  and  expanded  for  the  Unities 
installation;  hence  the  description  is  included  in  this 
a PDendix  . 
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Command:  UTS 

Purpose:  To  execute  a nultics  command  (s)  and  return  control  to 

the  Analyzer. 

Prototype;  MTS  Nul  t ics-com  man  d 
Para  meters: 

Nultics- command  line 

Only  th3  N ul t i cs- coraman d line  is  executed  and  then 
control  is  returned  to  UR  A.  All  Mviltics  conventions 
apply  to  this  command  line.  Multiple  coaaajids  aust 
he  separated  by  comas.  User  abbreviations  are 
permitted.  Anv  Nultics  coaaand  is  allowed. 

Examples:  NTS  LIST  * . hr  AT  EM  P -BR  -NHE  ; ?WD 

NTS  OSPX  UR  A EPS  . (JRT. 


Notes  for  running  under  Nultics: 

For  any  single  terminal  session  under  Nultics,  the  NTS 
coaaand  has  the  effect  of  exiting  from  the  Analyzer  and 
issuinq  the  Nut  lies  command.  This  dif  fers  froa  the  STOP 
coaaand  as  t.h?  STOP  terminates  the  USA  session,  and 
requires  the  ereo-cora  command  to  return  to  URA  aoda.  Not 
only  does  the  NTS  command  save  aoney  (URA  is  not 
terminated)  , but  it  also  retains  the  parameters  set  in  the 
SET  command  and  contents  01  the  NANE-OEN  defau’ t file,  etc. 
A STOP  would  require  that  these  parameters  be  restated. 

The  Nultics  ch a nqe-work ing-di rector y (cwd)  coaaand  must  be 
used  with  caution.  The  Analyzer  aust  always  be  running 
from  the  vorkinq  directory  in  which  it  was  in  itialLy 
invoked.  The  user  must  not  perform  any  exec_coa  command 
that  will  alter  the  I/O  attach  units. 
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Comm  and : 
Purpose: 
Prot  ot.ype; 
Para  meters 


SFT  Type:  control  command 

To  set  various  qlohal  switches  and  parameters. 

S ET  [ Dara  meter  ]. . . 


n AT A- R AS E ( DR) =dat ase t- name  Default:  ura 

The  data  base  is  the  file  in  which  the  data  base 
information  is  assembled  and  stored.  This  facility 
allows  the  user  to  chanqe  the  data  base  beinq  used  in 
the  middle  of  an  Anaylzer  session.  The  suffix  ,dbf 
should  not  he  qiven.  The  full  relative  or  absolute 
pathname  should  be  used.  No  abbreviations  ace 
recoqnized . 

ECHO ( E) = {ON  Default:  E3HOOFF 

{OFF 

with  "ECHO"  set  equal  to  ON,  the  commands  are  prints! 
on  the  current  output  device  as  they  are  encountered. 
This  is  more  desirable  in  batch  (command  is  printed 
on  line  printer)  than  in  on-line  mode  (the  command  is 
echoed  back  at  the  terminal). 

H EADI NG (H ) - (ON  Default:  HEADING-ON 

{OFF 

With  "UFA  DING”  set  OFF,  print inq  of  headinqs  (date, 
title,  p.aqe  number,  etc.)  of  each  report  will  be 
suppressed.  Headinqs  will  be  printed  when  th o switch 
is  set  ON  . 

LINES  (L)  = i nteqer  Default:  LINES«46 

The  number  of  lines  printed  per  report  paqe  is  set  to 
the  indicated  number.  The  default  number  fits  the 
output  to  an  8-1/2  x 11  inch  paqe  for  convenient 
bindinq.  "LINES"  may  take  on  any  value  between  10 

and  SOP. 

MODF-  {BATCH  (H)  Default:  modesterminal 

(rEPMINAL(T) 

This  switch  sets  other  switches  particular  to  the 
mode  of  operation  such  as  "prompt"  and  "echo". 

OUTPUT  (0)  =da ta se+  -name  Default:  term 

This  oarameter  specifies  the  data  set  into  which  all 
subsequent  URA  reports  are  written.  If  no  OTTPUT 
file  is  specified,  all  output  is  written  on  the 
terminal  data  set. 
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PARAMETERS  (PAPM)  * (ON  Default:  ON 

(OFF 

With  "PARAMETERS"  set  OFF,  the  printing  of  the 
parameters  in  effect  for  the  production  of  each  DRA 
report  will  be  suppressed.  Parameters  will  be 
printed  when  the  switch  is  set  ON. 

PPORL FH-N AME (PNAM)  suser-naroe  Default:  Air  Force 

ESD/R  ADC 
Multics 

The  " PPDB L EM- NAME"  is  the  title  that  goes  on  each 
page  of  the  output.  it  must  be  a rjRl  name,  that  is, 
it  must  begin  with  a code  3 character,  be  no  more 
than  30  characters  in  length,  and  be  compose!  of  coda 
3 and  4 characters  with  no  intervening  blanks. 

PROMPT  (P)  = {ON  Default:  PROMPT=ON 

(OFF 

If  "PROMPT"  is  sat  to  ON,  DRA  will  prompt  the  user 
for  the  correct,  command  or  parameters  when  an  error 
is  encountered.  With  "PROMPT"  set  to  OFF,  DRA  will 
iqnore  invalid  commands  and  parameters  and  proceed  to 
the  next  command  or  Parameter. 

Examples:  SET  DB=WP74  PNAM  = W. P.74_ EXAMPLE  0=?RINT.EILE 
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Command:  STOP  Type:  control  command 

Purpose:  To  terminate  execution  of  the  UFA  software  and  return 

control  to  Multics.* 

Prototype;  STOP 
Parameters: 

None 

rx.amnle:  STOP 


1 Issuing  this  command  returns  all  storage  used  by  URA  for 
tables,  buffers,  parameters,  scratch  files,  etc.  All  files 
havinq  the  suffix  .uratemp  are  deleted.  To  restart  execution  of 
UFA  the  user  must  give  the  Multics  command: 

exec_com  >ml>CAFA>ura 

Tf  the  user  leaves  (IRA  mode  and  enters  Hult.ics  without  use  of 
the  "STOP"  command,  the  user  should  issue  the  Hultics  "start" 
command  to  return  to  UFA. 
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2.  Bala  Sas.  saaina  Qzzi* mio^s  3EA  is  aaliias 


Version  3.2  of  the  Analyzer  has  been  improved  from  the  human 
enqineerinq  perspective.  Speci f icaliy,  the  file  naming 
conventions  have  been  improved.  The  user  does  not  have  to 
remember  as  aany  files  as  has  been  the  case  with  previous 
hnalyzer  versions. 


2.  1 Nailing  the  Data  Base  Pile 

The  user  no  lonqer  aust  coaait  to  aeaory  the  several  files 
associated  with  each  data  base,  the  tables  and  index,  nor  the 
suffix  on  the  nines  of  each  file.  The  data  base  naae  is  the 
naae  that  the  user  wishes  to  use  to  refer  to  his  data  bise.  Tho 
Analyzer  will  attach  any  necessary  suffix  to  refer  to  actual 
Kultics  segments.  The  data  base  nay  have  any  valid  Multics 
sequent  name. 


2.2  Naming  Temporary  Data  Sats 


Ml  temporary  files  maintained  by  the  Analyzer  have  the  suffix 
.uratemp  attached  to  their  name.  When  the  Analyzer  is 
terminated,  two- component  segments  with  .uratemp  as  the  suffix 
are  deleted.  Some  PUNCH  files  are  considered  to  be  temporary 
unless  the  user  supplies  a nane  with  a different  suffix  (see 
sect  ion  4) , 

Example* 

The  commands: 

NANF-GEN  PHNCH=M YPUNCH  S = "ALL" 

VAME-GEN  PUNCH=MYPUNCH. URATEMP  S=«ALL" 

cause  names  to  be  written  in  the  data  set  MYPUN3H  and  to 
MYPFTNCH.  URATEMP  respectively.  The  latter  data  set  will  be 
deleted  at  the  end  of  the  session. 


3.  !2S£S  oq.  Ex£cutina  ander  muss 


*•1  £i£aiin2  ani  iDiiializiaa  m gases 

before  the  user  can  add  information  to  a ORA  data  base,  the  data 
base  must  exist  and  be  initialized  properly,  creating  m 
initialized  data  base  in  the  user's  working  directory  is  a 
simple  one-step  process.  The  user  should  type: 

ec  >ml>CARA>Lnitdb  (name)  (size) 
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size  parameter  is  optional  and,  if  given,  should  be  the 
desired  size  of  the  data  base,  chosen  from  those  sites  presently 
available.  The  default  size  if  not  given  is  20.  The  name 
parameter  is  also  optional  and,  if  given,  is  the  name  that  URA 
will  use  to  reference  the  data  hase.  Vote,  a suffix  of  .dbf 
should  not  be  given  by  the  user.  The  default  name  used  if  name 
is  not  qiven  is  "ura."  If  the  size  parameter  is  to  be  used, 
then  the  name  must  also  be  given. 


3.2  Fixer utjnq  the  Analyzer  under  Hultics 

To  initialize  the  Analyzer  and  enter  URA  mode,  the  following 
command  should  he  given: 

ec  >ml>CARA>ura  ' 1 

(•  « 

The  Analyzer  will  respond  "Enter  command  (and  any  parameters)"  ' 

when  it.  is  ready  to  accept  each  command.  Ignore  any  "No  I/O  p 

switch"  messages.  t 

If  the  user  issues  an  interrupt  to  the  Analyzer,  then  the 
execution  may  be  resumed  at  the  point  of  interruption  by  issuing 
th«  command: 

start 

The  user  should  not  interrupt  the  Analyzer  during  a data  base 
update  or  modification  command  as  this  could  leave  the  lata  basa 
in  an  inconsistent  state. 

» *3 

t J 

Tf  the  user  interrupts  the  Analyzer  during  a report  comaand  or 
while  UFA  is  idle  and  wishes  to  prematurely  terminate  the 

Analvzer  and  begin  again,  the  Unities  commands  are:  f 4 

- 

i-St 

close-file-all  j 1 

release-all 
>ml>0  A R A >cl osei t 

■•I 

Th e user  must  use  the  SET  command  to  reset  any  parameters  for  > 

each  Analvzer  session. 
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Example 

Isain  nsfiiii 

password 

ec  >ml>CARA>initdb  sydb 

«c  >ml>CAPA>ura 
set  dh*mydb.dhf  o=temp. print 
input-psl  input*afile.url  update 

name-gen  s='all' 

f ns 

ston 

dprint  te«p, print 
logout 


UR A sessions 

Llaaia  la  aaUUsJ 

[user  password  to  Hultics] 

[create  and  initialize  an 
empty  data  base] 

[enter  ura  mode] 

[set  control  information] 

[update  URA  data  base 
using  contents  of 
afile.url  in  currant 
working  directory] 

[get  list  of  all  names] 

[get  FPS  for  all  names] 

[leave  UFA  mode] 

[print  output  - line 
printer  ] 

[logout  of  Hultics] 
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A subsequent  session  nay  enter  more  input  and  generate  some 


repo  rts. 

logia  Userid 
pass  word 

> nl>CAR A>  ura 

set  db=mydh  pnam =Mult ics-exanpl 
input.-psl  input.=sonef  ile.url 

name-qen  s=' process' 
pict  ure 

name-gen  s='all' 

f ps 

stop 

logout 


Ll°£iJ>  to  fiuUicsJ 

[user  password  to  Multics] 

[enter  URA  node] 

e [set  control  inforaation] 

pdate  [update  the  data  base 
using  the  contents  of 
somefile. url] 

[get  list  of  process 
names  ] 

[get  Picture  report  for 
each  process  nane] 

[get  list  of  all  laaes] 

[get  PPS  for  all  nates] 

[leave  UBA  node] 

[logout  of  Multics  ] 
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o.  Multics  Default  Sequent  nsips 

■"able  a presents  a suauary  of  Multics  default  sequent  maes  use! 
in  conlunction  with  each  UFA  coaaand.  The  "Default  Input  Pile" 
is  the  default  seqaent  used  as  input  to  the  coaaand  if  no  other 
sequent  set  has  been  specified  (i.e. , via,  the  "INPUT«"  or 
"FILM*"  paraueter.)  A dash  in  the  entry  desiqnates  that  the 
coaaand  has  no  Input  data  paraaeters, 

""he  "Default  PUNCH  File"  is  the  default  sequent  used  to  store 
PUNCH  data  froa  the  coaaand  if  no  PUNCH  seqaent  is  desijnated 
via  the  "PUNCH="  Dacaaeter,  A dash  in  the  entry  desiqnates  that 
no  PUNCH  data  can  ha  obtained  directly  froa  the  coaiand.  (PUNCH 
data  is  data  that  is  directly  acceptable  as  input  to  a 3RA 
coaaand.) 
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romp  and 


Multics  Default  Segment  Naies 
Da  fa  ult  Input  Pile 


Default  PUNCH  Pile 
C H A NG E-T YDF~~ 

CONS  TS"'S  -COM  P API  SON 
CONS  TS^S-  MATRIX 
CO NT  PNTS 
DATA -PROCESS 
DELETE 

DFLPTF-COMMFNT-ENTRY 

DFLFTE-PSL 

DICTIONARY 

ENTITY-IDENTIFIER 

EXTENDED-PICTURE 

FORM  ATTFD-PR03LEM-ST ATFMEN? 

FREQUENCY 

TNP'IT-PSL 

k wir 

N AM  ^ -OFN 

NAME-LIST 


urana  me 

tiraname 

uraname 

uraname 

uraname 

uraname 

urana  me 

ter* 

uraname 

u raname 

uraname 

uraname 

term 
urana  me 


ura  temp 
uratemp 
ura  temp 
uratemp 
uratemp 
uratemp 
ura  temp 

uratemp 
ura  temp 
ura  temp 
uratemp 


ura  temp 


picture 

PR  IN  T- ATTPI  B UTP-  VALUES 
PROCESS-CHAI  N 
PR  DC  ESS  - INPUT -!DU  TP  UT 
nUNCH-COHNENT-',NTPY 
F FN  A M E 

°EnL ACE- COM WENT- ENTRY 
RESOURCE-CONSUMPTION- ANAL YSI S 
SFCHR IT Y-ANA LYSIS 
S'f’SUCTUP  E 


uraname. uratemp 
uraname. uratemp 
uraname. uratemp 
uraname. uratemp 
uraname.  uratemp 
no  default 
urapcom. comment 
uraname. uratemp 
u raname. uratemp 


SUM’*  ARY 


uraf ps. url 


uraname. uratemp 


uraname. uratemp 
urapcom.  comment 


TABLE  E.1 
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code  i character 

•lit a sot 
file 

«Milti-scq*pnt  file 
pathname  (absolute) 

pathname  (relative) 

quit  signal 

segment 

u*>A  session 

work  l mi  directory 


MULTfCS  GLOSSARY 


A character  allowed  in  any  position  in  a 
HPL  name.  See  Appendix  B. 

A synonym  for  seqment. 

A segment  or  ault i-seqnent  tile. 

A file  composed  of  multiple  page  units. 

The  connotation  of  a segment's  entry-nan* 
with  all  superior  directories  leading 
back  to  the  storaqe  system  root. 

The  pathname  that  uniquely  names  a 
segment.  relative  to  the  workinq 
di rectory. 

The  meins  by  which  users  may  interrupt 
Multlcs  from  processing  a proqraa  or 
roam  and  lines. 

The  basic  unit  of  information  within  the 
Multi cs  storage  system.  Rach  segment  has 
access  attributes  and  a name,  and  nay 
contain  data,  programs,  or  bo  null. 

An  interactive  session  between  the 
Multics  command  "ec  >uid>CAR A >ura " and 
the  UR  A command  "stop." 

The  directory  under  which  the  user  is 
doing  his  work. 


I 

\ 

I 
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Appendix  P 

EXAMPLE  OF  DOCUMENT  SCHEMA  AND  SOURCE 
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This  appendix  consists  of  two  examples,  a Fuctional 
Description  and  a Data  Requirement s Document.  Bach  example 
consists  of  a schema  and  a corresponding  source.  The  examples 
are  presented  in  the  following  order: 


Schema  for 
Source  for 
Schema  for 
Source  for 


the  Functional  Description 
the  Functional  Description 
the  Data  Peouirements 
the  Data  Requirements 


Appendix  P Fx ample  of  Document  Schema  and  Source 


1 *TITLE  FUNCTIONAL  DESCRIPTION 

2 * HEA D IN 0- MARGIN  3 

3 #1.  FUNCTIONAL  DESCRIPTION  - GENERAL 

4 5 THIS  IS  AN  EXAMPLE  DOCUMENTATION  SCHEMA  OP  THE  FUNCTIONAL 

5 5 DESCRIPTION  POUND  IN  DOD  MANUAL  4120.  17-M. 

5 *1.1  PURPOSE  OF  FUNCTIONAL  DESCRIPTION 

1 11.2  PROJECT  REFERENCES 
3 #2.  SYSTEM  SUMMARY 
3 *2.1  BACK  GPO  UN  D/PUR  POSES 
1"  *2.2  OBJECTIVES 

11  *2.3  EXISTING  METHODS  AND  PROCEDURES 

12  *2.4  PROPOSED  METHODS  AND  PROCEDURES 

13  *2.4.1  SUMMARY  OF  IMPROVEMENTS 

14  *2.4.2  SUMMARY  OF  IMPACTS 

15  #2. 4.2.1  EQUIPMENT  IMPACTS 
15  *2. 4.2. 2 SOFTWARE  IMPACTS 

17  #2.4.2.  3 ORGANIZATIONAL  IMPACTS 
13  #2. 4. 2. 4 OPERATIONAL  IMPACTS 
19  #2. 4.2.5  DEVELOPMENT  IMPACTS 
29  #2.5  EXPECTED  LIMITATIONS 

21  #3.  DETAILED  CH A RACTERI STICS 

22  *3.1  SPECIFIC  PEPPORMANCE  REQUIREMENTS 

23  *3.1.1  ACCURACY  AND  VALIDITY 

24  #3'.  1 . 2 TIMING 

25  #3.2  SYSTEMS  FUNCTIONS 
25  #3.3  TNPUTS /OUTPUTS 

27  #3.4  DATA  CHARACTERISTICS 
23  #3.5  FAILURE  CONTINGENCIES  . 

29  #4.  ENVIRONMENT 

3"  #4.1  EQUIPMENT  ENVIRONMENT 

31  #4.2  SUPPORT  SOFTWARE  ENVIRONMENT 

32  #4.3  INTERFACES 

33  #4.4  SECURITY 

34  #5.  COST  FACTORS 

35  #6.  DEVELOPMENT  PLAN 
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1 tl.  FUNCTIONAL  DESCRIPTION 

2 «SET  DB*  S PGE  X 

3 *HEA  DING- SKI P 3 

4 *TOP-LIN  ES  2 

5 ♦BOTTOM- LINES  2 

6 R ’’’HIS  IS  AN  EXAMPLE  DOCUMENTATION  SOURCE  OP  THE  FUNCTIONAL 
1 R DESCRIPTION  STANDARDS  FOUND  IN  DOD  MANUAL  4123.  17-M. 

B 6 IT  IS  WRITTEN  IN  CONJUNCTION  THE  EXAMPLE  DATA  BASE  FOUND 
4 R IN  ISDOS  WP  74. 

10  *SKIP  1 

11  *1.1  PURPOSE  OF  FUNCTIONAL  DESCRIPTION 

12  *SKIP  1 

13  THIS  PUNCTTONAL  DESCRIPTION  FOR  THE  PAYSTATEHENT  EXAMPLE, 
PROJECT  *1 

14  IS  WRITTEN  TO  PROVIDE: 

15  A.  THE  SYSTEM  REQUIREMENTS  TO  BE  SATISFIED  WHICH  WILL  SERVE 
AS  A 

1*  BASIS  POR  MUTUAL  UNDERSTANDING  BETWEEN  THE  USER  AND  THE 


DEVELOPER. 

17  8.  INFO  PM  AT  ION  ON  PERFORMANCE  REQUIREMENTS,  PRELIMINARY 
DESIGN,  AND 

IS  USER  IMPACTS,  INCLUDING  FIXED  AND  CONTINUING  COSTS. 

19  C.  A BASIS  FOR  THE  DEVELOPMENT  OF  SYSTEM  TESTS. 

20  #1.2  PROJECT  REFERENCES 

21  *SKIP  1 

22  THE  PAYROLL  DPPA  RTMENT  IS  THE  SPONSOR  AND  USER  DF  THIS 
MANAGEMENT 

23  INFORMATION  SYSTEM.  THE  ACTUAL  OPERATION  OF  THIS  SYSTEM 
WILL  BE 

24  HANDLED  BY  BOTH  THE  PAYROLL  DEPARTMENT  AND  THE  DATA 
PROCESSING 

25  DEPARTMENT. 

76  *SKT P 1 

27  A.  A COPY  OP  THF  PROJECT  REQUEST  IS  IN  THE  APPENDIX. 

29  P.  STANDARDS  AND  REFFERENCE  DOCUMENTATION 

29  1. ISDOS  WORKING  PAPERS  74,36,90 

30  2. DOD  ADS  DOCUMENTATION  STANDARDS  MANUAL  4123. 17-M 

31  *HEADIN3-SKIP  61 

32  *2.  SYSTEM  SUMP* A RY 

33  *SKTP  1 

34  THIS  SECTION  SHALL  PROVIDE  A GENERAL  DESCRIPTION,  WRITTEN  IN 
IS  NON- A DP  TERMINOLOGY,  OF  THE  PROPOSED  ADS. 

36  *HEA  DING-SKIP  9 

37  #2.1  BACKGFOUND/PURPOSES 

38  *SKI  P 1 

39  1PCOM  N«DACK  GROUND-MEMO  DESC  NOPUNCH 

40  *2.2  OBJECTIVES 

41  *SKT  P 1 

42  tPCCM  N*OBJECTTV  FS-MEMO  DESC  NOPUNCH 

43  *2.3  EXISTING  METHODS  AND  PFOCEDURFS 

44  *SICIP  1 

45  SINCE  THIS  TS  A NEW  COMPANY,  THERE  IS  NO  APPLICABLE  EXISTINJ 

46  PROCEDURE  FOR  DOING  TUP  PAYROLL. 

47  *2.4  PROPOSED  METHODS  AND  PROCEDURES 
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48  * SKI P 1 

49  ’PCOM  N=PEOCESS-FEMO  DESC  NOPUNCH 

50  ’HOLD  43 

M ’PTC  N = M A IN- PFOCFSS  NOSTRUCTUFE 

52  ’HEADING-SKIP  2 

53  *2.4.1  SUMMARY  DP  IMPROVEMENTS 
64  ’SKIP  1 

6 5 A.  STAPPIVG 
66  ’SKIP  1 

57  ’PCOM  N= PAYROLL- DEPT- EM PLOY  EES  DESC  NOPUNCH 

58  ’SKIP  1 

59  B.  TIMELINESS 

60  ’SKIP  1 

61  KFPS  NLNS  NPEOF  N =ONE 

62  *2.4.2  SUMMARY  OF  IMPACTS 

63  ’SKIP  1 

64  *2.4.2.  1 ’09  TPM E NT  IMPACTS 

65  ’SKIP  1 

66  A LIN’S  PRINTER  CAPABLE  OF  PRINTING  CHECKS  IS  NECESSARY. 

67  EQUIPMENT  CAPABILITIES  ARE  DISCUSSED  IN  PARAGRAPH  4.1. 

69  *2. 4.2. 2 SOFTWARE  IMPACTS 
6 9 ’SKIP  1 

70  THERE  ARF  FIVE  BASTC  SOFTWAPE  AREAS  WITHIN  THE  PAYROLL 
SYSTEM. 

71  ’SKIP  1 

72  *NG  S = ' SO=MA IN-PFOCESS,  1 ' 

’’3  ’HOLD  43 

74  t PTC  N=MAIN- PPOCFSS  NODATA  NOFLOW 

75  #2.4.2.  3 ORGANIZATIONAL  IMPACTS 
06  ’SKIP  1 

77  SPPS  NLNS  NPEOF  N =PE S PON  SI B ILIT1 ES 

7 8 ’HEADING-SKIP  50 

79  *2. 4. 2.4  OPERATIONAL  IMPACTS 

90  ’HEADING-SKIP  2 

91  ’PFPORT-CC  OFF 

82  ’SKIP  1 

83  A.  OPERATIONAL  STRUCTURE 

94  ’ STF  PROCESS 

95  ’NEW-DAGE 

96  R.  TIMELINESS  (OPERATIONS  AND  DATA) 

97  ’SKIP  1 

89  HERE  IS  A SUMMARY  OF  FREQUENCY  DATA. 

99  ’SKIP  1 

90  *NG  S=' INTERVAL'  NOPPINT 

Q1  tFPFQ  OS  DER  = BYTY  PE  INTERVAL 

92  ’NEW-PAGE 

93  C.  INPUTS 

94  ’ STR  INPUT 

95  ’SKIP  2 

96  D.  DATA  RETENTION 
99  * SKI  P 1 

98  tPCOM  N=M  ASTER-FILE  DESC  DER  NOPUNCH 

99  ’HOLD  43 

100  ’PIC  N=N  ASTER-FI I E NODATA  NOFLOW 
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102 

103 

104 

105 

106 
137 
105 

109 

110 
111 
112 
11? 

114 

115 

116 

117 

118 

119 

120 
121 
122 

123 

124 
126 
126 

127 

128 

129 

130 

131 

132 

133 
1 34 
136 
1 36 
137 
1 38 

139 

140 

141 

142 

143 

144 
146 

146 

147 

148 

149 
160 
161 
162 

153 

154 


♦HEADING-SKIP  59 

*2.4.2. 5 DEVELOPMENT  IMPACTS 

♦REPOFT-CC  ON 

•SKIP  1 

*PPS  NLNS  NPEOF  N*COMPLEXITY-LEVEL 
♦SNTP  2 

<PPS  NLNS  NP EOF  N^DEVFLOPMENT- NEEDS 

♦HEADING-SKIP  3 

*2.6  EXPECTED  LIMITATIONS 

♦SKIP  1 

ERPCRS  MILL  BF  NECESSARY  FOB  PAD  DATA  INPUT 
♦SKIP  1 

«PCOM  N=EPROR-T  TSTING  DESC  NOPUNCH 
♦HOLD  43 

<PIC  N=ERPOP-LISTING 
♦HOLD  43 

tPIC  N=EFR09-LTSTING- ENTRY 
♦HEA  DINS- SKIP  59 
*3.  DETAILED  CHARACTERISTICS 
♦HEA DING- SKIP  3 
♦SKIP  1 

*3.1  SPECIFIC  PERFORMANCE  REQUIREMENTS 
♦SKIP  1 

( SFF  SECTION  ?) 


♦SKIP  1 

5 EPS  NLNS  NPEOF  N =PAYROLL- PROCESSING 
♦SKIP  2 

DATA  RECEIVED: 

«NG  S* • I N PUT  OR  SET*  ORDER  = PYTYPE 
♦SKIP  7 

OUTPUTS  GENERATED: 

♦SKIP  2 

NNG  S*' OUTPUT* 

*3.1.1  ACCURACY  AND  VALIDITY 
♦SKIP  1 

‘XPCO M N=  ACCURACY-MEMO  DESC  NOPUNCH 
♦SKIP  2 

6FPS  NLNS  NPEOF  N = V ALI DI TY-CHFCK 
♦HOLD  43 

«PTC  N=HOURL Y- PA YCH EC K- VALIDATION 
♦NEW-PAGF 

*PIC  N=SALAR I FP- PAYCHECK- VALIDATION 
*3.  1 . 2 TIMING 
♦SKIP  1 

THE  FOLLOWING  IS  A DESCRIPTION  OP  THE  FUNCTIONAL  FLOW. 
♦SKIP  1 

FOP  SALAFTED  FM  PLOY EES  - 

♦SKIP  1 

6 FpS  NLNS  NPEOF  N *S A LARI  ED- EMP -PROCESSING- IN  IT 
NPPS  NLNS  NPEOF  N = VALTDI TY-CHFCK 
*PPS  NLNS  NPEOF  N ^PASSED- ERROR-CHECK S 
tPPS  NLNS  NPEOF  N*SALARI ED- PAYCHECK- PROD-INTT 
♦SKIP  2 

FOR  HOURLY  EMPLOYEES  - 


Appendix  P Example  of  Oocuneni  Schema  and  Source 


H 61  8C/Multics/URA  User's  Manual 


333 


1 


155  *SKT  P 1 

156  *FPS  NLNS  NPBOP  N=HOURLY-EMP-PROCESS ING-INIT 

157  tPPS  NLNS  NPBOP  N =VALTDI TY-CHECK 

158  <PPS  NLNS  NPBOP  N-TIM E-CAR D-MISSING 

159  1»PS  NLNS  NPBOP  N=PASSED-ERFOP-CHECKS 

169  tFPS  NLNS  NPBOF  N=HOURLY-P A YCHECK-PROD-INIT 

151  «PPS  NLNS  NPBOF  N =N EW-EM PLO YEE-PROCESS ING-IN IT 

152  SPPS  NLNS  NPBOF  N=TEPMIN ATION-PROCESSING-INIT 

153  *HEA  DINS- SKI P 59 

164  #3.2  SYSTEM  FUNCTIONS 

165  ♦HEADING-SKIP  3 

166  * FEPORT-CC  0pP 
157  *SKTP  1 

168  *NG  S= ' SO=H A IN-PROCESS, 1 ' NOPRINT 
164  ♦SKIP  1 

170  THE  VAR  I OHS  SUB-  FUNCTION  S OF  THE  SYSTEM  ARE: 

171  *SKTP  1 

172  NPCOM  DE  SC  PRCD  NOPUNCH 

173  #3.3  INPUTS/OUrPUTS 

174  ♦ SKIP  1 

175  INPUTS: 

176  "SKIP  1 

177  tNG  S=' INPUT ' NOPRINT 

178  tFPS  NLNS  NPBOP 

179  *SKT  P 2 

190  OUTPUTS:. . 

181  *SKTP  1 

192  *NG  S=' 0 UTPUT*  NOPRINT 

193  KF^S  NLNS  NPEOF 

184  ♦SKIP  2 

185  VSTR  OUTPUT 

196  #3.4  DATA  CHARACTERISTICS 
187  ♦ FEPORT-CC  ON 
189  *SKIP  1 

189  *PPS  NLNS  NPEOF  N=PAYROLL-M ASTER-INFORMATION 

190  * SKI P 2 

191  ft  THE  FOLLOWING  LINES  ARE  EXCLUSIVE  TO  THIS  DOCUMENT 

192  VPCOM  N = DEPA  RTMENT-PILE  DESC  DER  VOLS  NOPUNCH 

193  * SKI P 1 

194  "5PCO  M N = HOURLY- EM  PLOY  EE*  FILE  DESC  DER  VOLM  NOPUNCH 

195  *HOLD  43 

196  *PIC  N= HOURLY- EM  PLO YEE- PILE 

197  *NEH-PAGE 

199  VPCOM  N = SALARIED- EMPLOY E E- FILF  DESC  DER  VOLM  NOPUNCH 

199  *HOt  D 43 

200  tPIC  N=SALARIED-EMPLOYEE-FILE 

201  #3.5  FAILURE  CHARACTERISTICS 

202  *SKIP  1 

203  % PCO M N*  BACKUP-MEMO  DESC  NOPUNCH 

204  ♦HEADING-SKIP  61 

205  #4.  ENVIRONMENT 
2C6  ♦HEADING- SKIP  3 
207  *SKI P 1 

209  #4.1  EQUIPMENT  ENVIRONMENT 
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209  *SKIP  1 

210  9PC0H  N*  EQUIPMENT-MEMO  DESC  NOPUNCH 

211  *4.2  SUPPORT  SOFTWARE  ENVIRONMENT 

212  *SKIP  2 

211  «PCON  N * SOFT  WAR  E- MEMO  DESC  NOPUNCH 

214  #4.3  INTERFACES 

215  *SKTP  1 

216  tSTR  RWE 

217  *HOLD  43 

218  <PIC  N=ACCOU  NTIN  G -SYS TENS 

219  *NEW-PA3E 

220  tPIC  N=P AYPOLL-DFPARTMEN T 

221  #4.4  SECURITY 

222  * REPORT-  CC  OFF 

223  *SKI P 1 

224  tpcOM  N-SECURITY-MEMO  DESC  NOPUNCH 

225  tNO  S*»SECURITY*  NOPPINT 

226  «FPS  NLNS  NPEOF 

227  *HFA DINS- SKIP  M 

228  #5.  COST  FACTORS 

22U  tPCOM  N*COSTS-MEMO  DFSC  NOPUNCH 

230  #6.  DEVELOPMENT  PLAN 

231  *SKIP  1 

232  *PCON  N = DEV0  LPME  NT-MEMO  DESC  NOPUNCH 

233  *SKIP  2 

234  TFPS  NLNS  NPEOF  N =DEVFLO  PME  NT-TI MES 
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1 *TTTLF  DATA  REQUIREMENTS  DOCUMENT 

2 *HEADIN3-NARGTN  3 
1 *LINES  5C 

<4  *1.  GENERAL  DATA  REQUIREMENTS 

5 ft  THIS  IS  AN  EXAMPLE  DOCUMENTATION  SCHEM  OP  THE  DATA 
ft  ft  REQUIREMENTS  DOCUMENT  FOUND  IN  DOD  MANUAL  4123. 17-M 

7 *1.1  PURPOSE  OF  DATA  REQUIREMENTS 

8 *1.2  PROJECT  REFERENCES 

9 #1.3  MODIFICATION  OF  DATA  REQUIREMENTS 

10  *2.  DATA  DESCRIPTION 

11  #2.1  LOGICAL  ORG  ANIZ ATION  OF  STATIC  SYSTEM  DATA 

12  #2.2  LOGICAL  ORGANIZATION  OF  DYNAMIC  INPUT  DATA 

13  #2.3  LOGICAL  ORGANIZATION  OF  DYNAMIC  OUTPUT  DATA 

14  #2.4  INTERNALLY  GENERATED  DATA 

15  #2.5  SYSTEM  DATA  CONSTRAINTS 

16  #3.  USER  SUPPORT  FOR  DATA  COLLECTION 

17  #3.1  DATA  COLLECTION  REQUIREMENTS  AND  SCOPE 

18  #3.2  RECOMMEND  SOURCE  OF  INPUT  DATA 

19  #3.3  DATA  COLLECTION  AND  TRANSFER  PROCEDURES 

20  #3.4  DATA  BASE  IMPACTS 
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1 

2 

3 

U 

s 

6 

7 

9 

9 

1C* 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 
2 6 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 
39 
39 
<*n 

41 

42 

43 

44 


• 1.  GENERAL  DATA  REQUIREMENTS 

G THIS  IS  AS  EXAMPLE  DOCUMENTATION  SOURCE  OP  THE  DATA 
6 REQUIREMENTS  DOCUMENT  FOUND  IN  DOD  MANUAL  412D.17-M 
#1.1  PURPOSE  OP  DATA  REQUIREMENTS 
♦SNIP  1 

♦SOURCE- M ARG  IN  1 

THE  OBJECTIVES  OF  THIS  DATA  REQUIREMENTS  DOCUMENT  FOR  THE 
PATSTATEMENT  EXAMPLE,  PROJECT  #1  ARE  TO  LIST  AND  DEFINE  DATA 
FLEMENTS  WHICH  THE  SYSTEM  MUST  HANDLE  AND  COMMUNICATE  DATA 
COLLECTION  REQUIREMENTS  TO  THE  USER. 

#1.2  PROJECT  REFERENCES 

♦SKIP  1 

tSET  DB*  SPUE  X 

tPCOM  N-OBJECTIV  FS-MEMO  DESC  NOPUNCH 
♦SKIP  1 

tPCOM  N« PAYROLL-DEPARTMENT  DESC  NOPUNCH 
#1.3  MODIFICATION  OF  DATA  REQUIREMENTS 
♦SKIP  1 

NOT  APPLICABLE  TO  THIS  PROJECT. 

♦HEADING-SKIP  61 
#2.  DATA  DESCRIPTION 
♦SKIP  1 

♦SOURCE-MARGIN  5 
♦HEADING-SKIP  2 

THE  DATA  DESCRI B FD  IN  THIS  SECTION  SHALL  BE  SEPERATED  INTO 
TWO 

CATEGORIES,  STATIC  DATA  AND  DYNAMIC  DATA.  STATIC  DATA  IS 
DEFINED 

AS  THAT  DATA  WHICH  IS  USED  MAINLY  FOR  REFERENCE  DURING 
SYSTEM  OP- 
ERATION AND  IS  USUALLY  GENERATED  OR  UPDATED  IN  WIDELY 
SEPERATED 

TIME  FRAMES  INDEPENDENT  OF  NORMAL  SYSTEM  RUNS.  DYNAMIC  DATA 
IN- 
CLUDES ALL  DATA  WHICH  IS  INTENDED  TO  BE  UPDATED  AND  WHICH  IS 
TNPnT  TO  A SYSTEM  DURING  A NORMAL  RUN  (INCLUDING  "REAL  TIME" 
DATA 

SUCH  AS  TARGETING  DATA)  OR  IS  OUTPUT  BY  THE  SYSTEM.  STATIC 
DATA 

AS  DESCRIBED  ABOVE  IS  FREQUENTLY  REFERRED  TO  AS  PARAMETRIC 
DATA 

AND  DYNAMIC  DATA  AS  NON- PAR AHETR IC  DATA.  BOTH,  HOWEVER,  ARE 
COM- 
POSED OF  DATA  ELEMFNTS.  THE  DATA  ELEMENT  NAMES  LISTED  IN 
PARA- 
GRAPHS 2.  1,2. 2,  AND  2.3  SHALL  BE  THOSE  CONTAINED  IN  STANDARD 
DATA  ELEMENT  LIBRARIES,  WHENEVER  APPLICABLE. 

*2.1  LOGICAL  ORGANIZATION  OF  STATIC  SYSTEM  DATA 
♦SKIP  1 

K CONTENT S N*  M AST  FR-FILE 
•SKIP  1 

9 CONTENT  S N*  DEPT  - FILE 
♦SKIP  1 

^CONTENTS  N*  H-FM  P-FILE 


-i 

i 


|.J 


(■ 


'•  i 

,-ri 


I 


Appendix  F Fv aaple  of  Docuaent  Scheaa  and  Source 


H61 80/Mul  tics/UFA  User's  Hanual 


337 


45  *SKTP  1 

46  ^CONTENT S N=S-EMP-FILE 

47  #2.2  LOGICAL  ORGANIZATION  OF  DYNAMIC  INPUT  DATA 

48  *SKTP  1 

44  * REPORT- CC  OFF 

50  tNG  S = 'SO*FMP-rNFO,1  ' NOPRINT 

51  ^CONTENTS 

52  12.3  LOGICAL  ORGANIZATION  OF  DYNAMIC  OUTPUT  DATA 

53  *PEPOPT-CC  ON 

54  *SKT  P 1 

55  ^CONTENTS  N= PAY- STATEMENT 

56  * SKI  P 1 

57  ^CONTENTS  N= HOUR L Y-E MPLOYEE-RE PORT 
5ft  * SKI  P 1 

54  ^CONTENTS  N= SALA FIED- EMPLOY FE- REPORT 

60  * SKI  P 1 

61  ^CONTENTS  N= HIP F D-EM PLOY FE- REPORT 

62  *SKIP  1 

6 3 ^CONTENTS  N = TERM  T NATS  D- EMPLOY  EE- RE  PORT 

64  #2,4  INTERNALLY  GENEPATED  DATA 

65  *SKI P 1 

66  ^CONTENTS  N= ERROR-LISTING 

67  #2.5  SYSTEM  DATA  CONSTRAINTS 
6ft  * SKI P 1 

64  NFPS  N=I -0- CONST  R AINTS- M EMO 

70  *HEA "INS-SKIP  61 

71  #3.  USER  SUPPORT  FOR  DATA  COLLECTION 

72  *HEA  DING- SKT P 2 

73  tNG  S = ' INPUT  OR  OUTPUT'  OR D ER=  BYTYPE  NOPRINT 

74  tCNC 

75  *NEW-PA3F 

75  INFORMATION  IN  PEGARDS  TO  DATA  FLOW 

77  «DP  D 

78  *NG  S= ' ENTTT  Y ' NOPRINT 
74  *NEH-PA3E 

40  INFORMATION  ON  FFCORDS  KEPT 
81  *CNC 

42  *HOLD  54 

43  *3.1  DATA  COLLECTION  REQUIREMENTS  AND  SCOPE 

84  * SKI  P 1 

85  INFORMATION  NEEDED  IN  ORDER  TO  ESTABLISH  THE  VALUES 

46  OF  EACH  DATA  ELEMENT: 

47  *SKIP  2 

48  *Fps  N=S  ALARIED- EMPLOYM ENT- PORH 

44  %PPS  N = HOURLY-EM  PLOYMENT-FO  RH 

44  tFPS  N=T  A X-NTTH HOLDING- CERT I PI CATE 

41  NKPS  N=E  M PLO  YMEN  T-TER  MIN ATION- FORM 
4 2 * SKT  P 2 

43  INFORMATION  TO  8F  COLLECTED  BY  THE  USER: 

44  * SKI P 1 

45  *PPS  N=TIME-CARD 

96  * SKI P 2 

97  OTHER  SUPPLEMENTARY  INFORMATION: 

98  * SKT  P 1 
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99 
100 
1?  1 
102 

103 

104 
IDS 
106 
107 
109 

109 

110 
111 
112 

113 

114 

115 

116 
117 
119 

119 

120 
121 
122 

123 

124 
129 
126 
12-> 
129 

129 

130 


A.  INPUT  SOnRCF(S)  OP  THE  DATA  ELEMENT 
♦SKIP  1 

tPPS  N=  DEPARTMENTS-  AN  D- EMPLOYEES 
NFPS  N’BMPLOYEE 
«FPS  N=P  A YRO  LI.- DEPARTMENT 
♦SKIP  2 

B.  RECIPIENTS 
♦SKIP  1 

tET»S  N=  ACCOO  NTTNG-SYSTEMS 
♦SKIP  2 

D.  CRITICAL  VALUES 
tEPS  N*R E HA INTN3- FUNDS 
♦SKIP  2 

S.  OUTPUT  FORM/DEVICE 

♦SKIP  1 

«PCOH  N*H-EHP- REPORT  DESC  NOPUNCH 
♦SKIP  1 

NPCOM  N=S-wKP-FEPOFT  DESC  NOPUNCH 
♦SKIP  2 

F.  FRE3UFNCY  OF  UPDATE 

kfpfo 

• 3.2  RHCOH.MENDFD  SOUPCE  OF  INPUT  DATA 
♦SKIP  1 

THIS  TOPIC  HAS  OPEN  DISCUSSED  ABOVE ( S ECT ION  3.1. A) 

•3.  .3.  QAT.A  CO-LLECT  ION  AND.  TRANSFER  PROCEDURES 
♦SKIP  1 

THIS  TOPIC  HAS  BFEN  DISCUSSED  ABOVE  (SECT ION  3.  1.  F) 

• 3.4  DATA  BASF  IMPACTS 
♦SKIP  1 

«PCOH  N* DEPARTMENT- FILE  DESC  DFR  VOLS  NOPUNCH 
tPCOM  N = HOURLY- EM  PLOY PE- FILE  DESC  DE R VOLM  NOPUNCH 
*°COH  N*S  ALARIED-EHPLOYPE-  FILE  DESC  DER  VOLM  NOPUNCH 
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This  appendix  contains  examples  of  the  Functional  Description 
Document  written  using  the  Automated  Docunentation  Systaa.  The 
Analyser  data  base  used  is  the  Pay  Systes  exanple  described  in 
Part  IV  of  this  annual.  Due  to  space  limitations,  listings  of 
the  Analyser  data  base  are  not  included. 

The  followinq  list  of  Analyzer  coaaands  have  been  used  to 

produce  these  esaaples:  » 


SfillA&ll  flfilS 

Esiaisiais  Sssa 

CONSENTS 

FILF 

NAME 

1 

DATA  PROCFSS 

DATA 

FILE 

EPS 

NAME 

FILE 

PRINT 

FRF  QUENCY 

NA* E-GEN 

ENTITY 

INPUT 

OUTPUT 

PRINT 

NOPRINT 

SUBLEVEL 

SUBPART  OF 

SECURITY 

PICTURE 

DATA 

NODATA 

FILE 

NAME 

FLOW 

NO  FLOW 

STRUCTURE 

NO  STRUCTURE 

PON  CH- CO  MM  ENT- ENTRY 

DER 

DESC 

PROC 

VOLM 

VOLS 

FILE 

NAME 

NOPUNCH 

PRINT 

1 

STPUCTORE 

INPUT 

PROCESS 

RNE 
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OUTPUT 

Althouqh  these  are  the  only  commands  used,  all  Analyzer  commands 
nay  he  used  with  the  Autoaated  Documentation  Generator  (with  the 
exception  of  the  STOP  coaaand). 
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1 


Using  Multlcs,  the  Automated  Documentation  System  can  run  using 
the  following  command: 

exec-com  >ml>CARA>spg  schema-segment  source-segment 


This  command  will  do  all  syntax  checking  needed  and  generate 
document.  Output  for  the  document  will  go  to  the  file 
spg. output.  The  system  assumes  the  Analyzer  data  base  is  in 
file  uradb.dbf  unless  the  SET  command  is  used  to  change  the 
default  (i.e.,  SET  DB-file). 


the 

the 


Output  from  this  section  looks  as  follows: 


Line  TEXT 


CMNDS  SECTION 


2 

3 

4 

5 

6 

7 

8 
9 

*** 
10 
1 1 
12 
13 


& 

& A SMALL  TEST  EXAMPLE 

& 

0 0 -1.  SCOPE 

0 2 -1.1  IDENTIFICATION 

0 1 -1.2  FUNCTIONAL  SUMMARY 

* MISSING*  -1.3 

-1 . 4 

INVALID  SECTION  IDENTIFIER 
& 

0 0 -2.  APPLICABLE  DOCUMENTS 

13  2 -2.1  GOVERNMENT  DOCUMENTS 

5 l -2.2  NON-GOVERNMENT  DOCUMENTS 


SUMMARY 

8 SECTIONS 

1 OF  WHICH  ARE  MISSING  FROM  THE  SOURCE  FILE. 
18  TOTAL  TEST  LINES,  AND 
6 TOTAL  COMMAND  LINES. 


< 
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anal yst 

Analyzer 

content-  entry 

consent,  entry 
st at  amen  t 

cont  rol 
coaaands 

converse  tiona  l 
node 

data  base 

data  oblect. 

fdnaae 

f ilenaae 
input  file 

loqical 

description 

logical  systea 
desi  gn 
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5 LOSSARY 


Naae  used  synonymously  for  "problea  definer." 
One  who  aids  to  develop  the  problea  stateaent 
or  logical  systea  design. 

Synonya  for  "URA."  Is  the  software  package 
that  processes  problea  stated  in  the  Language. 

The  text  associated  with  a consent  entry 
stateaent.  DESCRIPTION,  PROCEDURE  and 
VOLATILITY  are  exaaples  of  stateaeats  which  are 
specified  by  consent  entries. 

Any  URL  stateaent  in  which  the  contents  of  the 
statement  are  defined  by  the  problea  definer 
(as  is  narrative  description).  The  DESCRIPTION 
and  PROCEDURE  statements  are  exaaples  of  this. 

Those  URA  coaaands  which  allow  the  URA  user  to 
pass  certain  control  infornation  to  the 
Analyzer.  They  are  particular  to  an  individual 
operating  systea. 

Interactive  use  of  the  computer  systea  through 
a terainal  device.  Used  synonyaously  with 
on-line  terainal,  or  interactive  node. 

The  data  base  referred  to  throughout  this  paper 
is  the  user'3  data  base  which  is  populated  by 
URA  froa  the  user  inputted  URL  stateaeats. 

Any  URA  name  type  that  represents  soae  fora  of 
data.  SETS,  INPUTS,  OUTPUTS,  ENTITIES,  GROUPS 
and  ELEMENTS  are  all  data  objects  described  by 
URL. 

Any  legal  file  or  device  name.  Allowable  names 
are  dependent  on  the  operating  systea  being 
used  . 

Any  legal  temporary  or  permanent  file  name  that 
is  to  be  specified  by  the  user. 

Any  teaporary  or  permanent  file  which  contains 
dita  to  he  used  by  URA  coaaands  via  INPUT  or 
PILE  parameters. 

Synonym  to  "problea  stateaent."  Set  of 
raquireaents  for  a new  systea. 

The  process  of  specifying  a problea  stateaent 
for  any  particular  systea. 
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*oli  f ier 
cor«  anils 

Mul t ics  Command 

Mult ics  Command 
Lang uaqe 

n a hi  e type 

physical  system 
desi  gn 

nhvsical  system 
lesi gner 


problem  definar 


dc ob lew 
st  a omen  t 


orom  ot 


PtJWC  H file 


report  commands 


segment 
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Commands  which  modify  the  contents  of  a (IRA 
data  base  in  the  manner  specified  by  the  user. 

A command  to  the  Multics  system;  an  element  of 
the  Hu  It ics  command  language. 

The  set  of  commands,  subcommands  and 
operands  recoqnixed  by  the  Multics  Operating 
Sys  t em. 

Anv  of  the  many  types  of  names  allowed  by  (JRL 
(i.e.,  PROCESS,  SET,  GROUP,  etc.).  See  "The 
user  Requirements  Language,  Lanquage  Reference 
Manual"1,  Appendix  E,  for  a list  of  all 
possible  name  types. 

The  process  of  specifying  a physical 
system  (consisting  of  software,  machinery, 
etc.)  given  a particular  problem  statement. 

Person  responsible  for  deriving  a 
physical  system  design  from  the  problem 
statement  generated  from  the  logical  system 
design  process. 

*15 ft d synonymously  with  "analyst."  That  person 
who  develops  the  requirements  stated  by  the 
users  into  a format  understandable  by  others 
and  in  sufficient  detail  to  be  usable  by  the 
physical  system  designer.  The  product  of  his 
work  is  the  problem  statement. 

A set  of  requirements  specified  by  users  of  a 
proposed  system  and  expressed  by  the  problem 
definer  into  a format  acceptable  by  the 
org  a nira  tion . 

A system  function  that  requests  the  terminal 
user  to  supply  operands  necessary  to  continue 
processing. 

A file  which  contains  data  (usually  URL 
user-names)  in  a format  that  can  be  used  as 
input  t.o  one  or  more  URA  commands. 

Those  commands  which  retrieve  data  froi  a URA 
data  base  and  output  it  in  soma  meaningful 
format . 

A named  collection  of  data  which  is  accessible 
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ter* 


undefined  na se 


UR  A 


USA  cossand 


UR A data  ha3e 


URL 


U*L  statesent 


user -naae 


• Part  if. 

* Part  IT  of  URL 


by  the  systes.  The  data  set  usually  resides  oa 
an  auxiliary  storage  device. 

Identifier  to  designate  that  the  terminal  is  to 
be  used  as  a source  of  input  or  area  foe 
oat  put. 

A naae  of  a URL  object  that  has  been  entered 
into  the  URA  data  base,  but  has  no  naae  type 
associated  with  it. 

Th»  User  Requireaents  Analyzer.  A softaare 
package  which  stores  inforaation  in  the  URA 
data  base  by  interprett ing  URL  stateaents  given 
as  input,  and  retrieves  inforaation  froa  the 
data  base  in  the  fora  of  reports. 

Any  of  the  eonnands  that  can  be  used  to  operate 
URA.  See  "User  Requireaents  Analyzer  Coaaand 
Descriptions"*  for  coaplete  descriptions  about 
each  coaaand  available  in  URA. 

File  where  URL  inforaation  is  stored  (in  a 
coded  foraat)  which  can  then  be  accessed  by  URA 
user. 

*he  User  Requireaents  Language.  The  collection 
of  all  URL  stateaents  allowed  for  use  by  URA. 
See  "The  User  Requireaents  Language,  Language 
Reference  Manual"*  for  coaplete  description. 

A stateaent  specified  by  "The  User  Requireaents 
Language,  Language  Reference  Manual".*  Bach 
stateaent  aay  define  a URL  object,  define  a 
consent  entry,  or  define  a relationship  aaonq 
two  or  aore  URL  objects. 

Any  leqal  URL  naae  specified  by  problei 
definer.  Also  called  a "usee  defined  naae". 
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Appendix  I 

ASCII  CHARACTER  SET  FOR  URA 
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The  attached  list  gives  foe  each  ASCII  character  a code  of  1 to 
4 classifying  the  characters  into  the  fo llo*inq  categories: 

Code  1:  Nonprinting  operating  Systea  and  transalssion 
control  characters  to  ba  treated  as  punctuation,  but  sill  always 
be  illegal. 

Code  2:  Puncutation,  delimiters,  etc.  which  are  not 
allowed  In  nasas. 

Code  3:  Characters  allowed  at  any  position  in  a naae. 

Code  4:  Characters  allowed  at  any  position  in  a naae  after 
the  first. 

There  are  three  versions  of  this  categorization: 

1.  A one  page  suaeary. 

2.  Sorted  by  Octal  representation. 

3.  Sorted  by  code,  then  by  octal  representation. 
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CDDF  1: 
CODE  2: 
CODE  3: 

CDDF  4: 


All  others 

H6'0  •,:;«?(  ]|- 

ABODE  FGH I J KLSNOPO  RSTMIVW  XYZ 
a bcde  f qhi Iklanopq  rstuvnxyT 

»•*«*  n 

1 1 2^4  S67B  9 

♦ -./<> 
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£225 

OCTAi 

£££2 

NAME 

1 

"3oo 

nul 

null  or  time  fill  char 

i 

*01 

soh 

start  of  heading 

i 

00? 

stx 

start  of  text 

i 

003 

etx 

end  of  text  (EOM ) 

i 

004 

eot 

end  of  transmission  (EOT) 

i 

005 

enq 

enauiry  (HR U) 

i 

0 06 

ack 

acknowledge  (RU) 

i 

007 

be  1 

bell 

i 

0 10 

bs 

backspace 

^11 

ht 

horizontal  tabulation  (TAB) 

i 

0 12 

If 

line  feed  (LINE  PEED) 

i 

0 13 

vt 

vertical  tabulation  (VT) 

i 

014 

ff 

form  feed  (PORM) 

i 

*14 

cr 

carriage  return  (PETORN) 

i 

0 If 

so 

shift  out 

i 

* 17 

si 

shift  in 

i 

0 ?.f 

die 

data  link  escape 

i 

021 

del 

device  control  1 (X-ON) 

i 

022 

dc2 

device  control  2 (TAPE) 

i 

*23 

dc  3 

device  control  3 (X-OPP) 

i 

0 24 

dc4 

device  control  4 (TAPE) 

• i 

0 25 

na  k 

negative  acknowledge 

i 

0 26 

sy  n 

synchronous  idle 

i 

0 27 

et  b 

end  of  transmission  blocks 

i 

0 30 

can 

cancel 

i 

* 31 

ei» 

end  of  medium 

i 

0 32 

ss 

special  sequence 

i 

0 33 

esc 

escape 

i 

* 34 

f s 

file  separator 

i 

0 35 

qs 

q roup  separator 

i 

0 36 

rs 

record  separator 

i 

0 37 

us 

unit  separator 
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COPF 

OCTAL 

CHAP 

2~ 

‘540 

sp" 

3 

0 41 

1 

2 

0 42 

» 

3 

"'43 

t 

1 

■>44 

t 

3 

0 45 

< 

2 

0 46 

s 

~> 

0 47 

t 

2 

SO 

( 

2 

0 51 

) 

2 

0 S? 

* 

4 

"S3 

♦ 

2 

C S4 

« 

4 

OSS 

4 

0 Sf 

• 

4 

C S7 

/ 

4 

0 sc 

n 

4 

0*1 

1 

4 

C 62 

2 

4 

0 S3 

3 

4 

<0  64 

4 

4 

Of  c 

S 

4 

0 sf 

6 

4 

0 67 

7 

4 

j 7C 

9 

4 

071 

q 

2 

072 

• 

•> 

073 

• 

4 

074 

< 

-> 

075 

s 

4 

076 

> 

2 

077 

2 

NAME 

space  (SPACE  BAR) 
exclamation  point 
quotation  nark 
number  siqn 
currency  symbol 
percent 
a m persand 
a post  rophe 
openinq  parenthesis 
closinq  parenthesis 
aster isk 
plus 
comma 

hyphen  or  minus 

period 

slant 

zero 

on  o 

two 

three 

four 

five 

six 

seven 

eiqht 

nine 

colon 

semicolon 

less  than 

equal 

qreater  than 
question  mark 


c 

\ 

b 

0 

,* 

F1’ 
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£20 E 2cI^t 

V ioo 

3 101 

3 102 

3 103 

3 104 

3 105 

3 106 

3 107 

3 1 10 

3 111 

3 1 12 

3 113 

3 1 14 

3 115 

3 1 16 

3 1 17 

3 1 20 

3 1 21 

3 122 

3 123 

3 1 24 

3 1 25 

3 1 26 

3 127 

3 1 30 

3 1 31 

3 132 

2 1 33 

3 1 34 

2 1 35 

3 1 36 

4 1 37 


CHAR  NAME 

9 connercial  at 

A 

B 

C 

D 

f. 

F 

G 

H 

I 

J 

K 

L 

M 

N 

0 

P 

Q 

R 

S 

T 

4 

0 

V 

w 

X 

T 

z 

[ openinq  bracket 

reverse  slant 
1 closing  bracket 

circuaf lex 
underline 
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£Q2£  221AI 

3 1 


£fl££  HAJil 

grave  accent 
a 
b 


opening  brace 
vertical  line 
closinq  brace 
t ilde 

delete  (RUBOUT) 


Aopendii  r ASCII  character  set  for  ORA 


H6  IRO/Multics/ORA  User's  Manual 


£2DE 

QCTAL 

£JjAR 

sins 

i 

500 

nul 

null  or  tiae  fill  char 

i 

001 

soh 

start  of  heading 

i 

002 

stx 

start  of  text 

i 

001 

etx 

end  of  text  (E01) 

i 

504 

eot 

end  of  transaission  (EOT) 

i 

0 0*i 

enq 

enquiry  (NRtJ) 

1 

a Of 

ack 

acknowledge  (RU) 

i 

007 

bel 

bell 

i 

0 1*1 

bs 

backspace 

i 

5 11 

ht 

horixontal  tabulation  (TAB) 

0 12 

If 

line  feed  (LINE  PEED) 

i 

5 11 

vt 

vertical  tabulation  (?T) 

i 

5 n 

ff 

fora  feed  (PORN) 

1 

*15 

cr 

carriaqe  return  (RETURN) 

i 

0 16 

so 

shift,  out 

i 

0 17 

si 

shift,  in 

i 

**  20 

die 

data  link  escape 

1 

021 

del 

device  control  1 (X-ONJ 

i 

022 

dc2 

device  control  2 (TAPE) 

i 

023 

1c  3 

device  control  3 (X-OPP) 

■» 

024 

dc4 

device  control  4 (TAPE) 

i 

3 25 

nak 

neqative  acknowledge 

1 

0 26 

sy  n 

synchronous  idle 

027 

et.  h 

end  of  transaission  blocks 

i 

0 3C 

can 

cancel 

i 

0 31 

era 

end  of  raediua 

i 

0 32 

ss 

special  sequence 

i 

0 31 

esc 

escape 

i 

0 14 

fs 

file  separator 

i 

3 35 

qs 

group  separator 

0 36 

rs 

record  separator 

i 

0 37 

us 

unit  separator 

i 

1 77 

del 

delete  (PIIBOOT) 

Appendix  I ASCII  character  set  for  URA 


H61 8C /Hul tics/URA  User's  Manual 


355 


£00  E 

OCTAL 

CHAR 

M«E 

2~ 

~040” 

sp 

space  (SPACE  BAR) 

2 

342 

tt 

quotation  mark 

2 

3 46 

6 

ampersand 

2 

3 47 

« 

apostrophe 

2 

0 50 

( 

openinq  parenthesis 

2 

3 51 

) 

closing  parenthesis 

2 

352 

* 

asterisk 

2 

054 

t 

coma 

-> 

072 

• 

colon 

2 

373 

• 

• 

semicolon 

2 

075 

X 

equal 

2 

077 

7 

question  mark 

2 

1 33 

[ 

openinq  bracket 

2 

1 35 

closing  bracket 

2 

174 

i 

vertical  line 

2 

1 76 

tilde 

£ 


HftlAC/nultlss/nBA  user's  Manual 


22IH 

£HA£ 

3 

3 41 

1 

axclaaation  point 

3 

043 

• 

nuaher  slqn 

3 

3 44 

t 

currency  syahol 

3 

045 

X 

percent 

3 

IOC 

a 

coasercial  at 

3 

101 

A 

3 

102 

.8 

3 

103 

C 

3 

104 

D 

3 

105 

8 

3 

106 

? 

3 

107 

(5 

3 

i 10 

H 

3 

111 

T 

3 

1 12 

il 

3 

113 

K 

1 

1 14 

L 

3 

110 

M 

3 

1 16 

N 

3 

117 

0 

3 

1 20 

P 

3 

1 21 

Q 

3 

12? 

R 

3 

1 23 

S 

3 

124 

T 

3 

125 

0 

3 

1 26 

V 

3 

127 

« 

3 

1 30 

X 

3 

1 31 

T 

3 

1 32 

Z 

1 
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CODE 

QiliL 

SAiLS 

3” 

1 34 

reverse  slant 

3 

1 36 

circuaflex 

3 

1 ur 

grave  accent 

3 

141 

a 

3 

142 

b 

3 

143 

c 

3 

1 44 

d 

3 

145 

e 

3 

1 46 

f 

3 

147 

g 

3 

1 SO 

h 

3 

1 S 1 

i 

3 

1 52 

1 

3 

153 

k 

3 

1 54 

l 

3 

155 

a 

3 

1 56 

n 

• 

3 

1 57 

0 

3 

1 6H 

P 

3 

161 

q 

3 

162 

r 

3 

163 

s 

3 

1 64 

t 

3 

165 

u 

3 

166 

V 

3 

1 67 

V 

3 

170 

X 

3 

171 

y 

3 

172 

z 

3 

1 73 

{ 

openinq  brace 

3 

1 75 

1 

closing  brace 
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£22!  2SX41  £BA£  BiBI 

tt  053  ♦ plus 

•»  0 55  - hyphen  or  sinus 

u 0 56  . period 

« 057  / slant 

4 0 50  0 zero 

h 061  1 one 

« 762  2 two 

h 063  3 three 

tt  064  4 four 

« 065  5 five 

1 066  6 six 

4 7 67  7 seven 

« 0 70  8 oiuht 

“ 071  9 nine 

•*  074  < less  than 

*•  076  > greater  than 

4 1 37  i underline 

f 

k 
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